内网 Windows 极客指南：从零跑起 OpenClaw 离线开发环境（2025 修正版）

最新的pnpm-airgap2.x 版本把之前博客中关于“零依赖引导工具”的部分彻底修正 重新发布一份完整、准确的离线部署指南。 内网 Windows 极客指南从零跑起 OpenClaw 离线开发环境2025 修正版没有互联网也能优雅地装上 Node.js、pnpm 和整个 OpenClaw 项目—— 一份写给小白、也写给所有爱折腾的人的离线部署手记你是否遇到过这种情景公司的开发机在纯内网不能连外网但你却想从 GitHub 上 clone 一个酷炫的项目比如OpenClaw来跑起来、改代码、甚至成为贡献者或者你只是想在一台完全离线的 Windows 电脑上把一套现代前端/Node.js 项目完整运行起来别怕。离线 ≠ 绝路。今天这篇文章我会带你一步一步像蚂蚁搬家一样从外网把需要的“干粮”全都搬到内网最后在你的 Windows 机器上跑起pnpm install和openclaw onboard。特别说明本文基于pnpm-airgap2.x 版本不再使用已废弃的bootstrap-publisher.js改用更简单的单一文件cli.cjs方式。全文分为四个部分搬家的第一件行李 —— Node.js 本体搬家的核心秘诀 —— pnpm 依赖大礼包最后的魔法 —— 本地仓库与离线安装新版收尾 —— 构建 运行 OpenClaw全程图文并茂、比喻生动小白也能跟着做。我们开始吧 第一部分搬家的第一件行李 —— Node.js 想一想为什么先装 Node.js因为pnpm本身是一个 Node.js 写的工具而 OpenClaw 项目也需要 Node.js 环境来运行构建脚本。所以Node.js 是一切的前提。✅ 你需要做的在外网电脑上找一台可以上网的电脑Windows / macOS / Linux 都行反正我们只下载安装包。打开浏览器访问 Node.js 官网 https://nodejs.org/en/download/找到Windows 64-bit的LTS 版本比如node-v22.14.0-x64.msi。LTS Long Term Support意思是稳定、可靠适合生产环境。点击下载得到一个.msi安装包。 搬到内网把下载好的node-vXX.msi复制到U盘或内网共享文件夹。然后在内网 Windows 机器上双击安装。安装过程中务必勾选“Add to PATH” —— 这样你才能在命令行里直接用node命令。✔️ 验证安装在内网机器上打开命令提示符cmd输入node -v npm -v如果看到了版本号比如v22.14.0和10.x.x恭喜你Node.js 已经安家落户了小贴士如果以后你需要管理多个 Node 版本可以顺便在外网下载nvm-windows一个 Node 版本管理工具然后像搬运其他文件一样搬进来。不过对于大多数项目一个 LTS 版本就够了。 第二部分搬家的核心秘诀 —— pnpm 依赖大礼包 pnpm 是什么为什么用它pnpm是一个比 npm 更快、更省磁盘空间的包管理器。OpenClaw 项目就是用 pnpm 来管理依赖的。离线安装 pnpm 的难点在于pnpm 本身需要从外网下载而且项目依赖更是成千上万个小文件。我们采用“大礼包模式”在外网把所有依赖都下载好然后整体打包搬到内网直接解压使用。 在外网机器上Linux / macOS 皆可做准备工作1. 安装 pnpm-airgap —— 一个专门为离线设计的工具npminstall-gpnpm-airgappnpm-airgap会帮你把pnpm-lock.yaml里列出的所有依赖包整整齐齐地下载到一个文件夹里就像打包行李一样。2. 克隆 OpenClaw 项目并进入目录gitclone https://github.com/openclaw/openclaw.gitcdopenclaw3. 运行pnpm-airgap fetchpnpm-airgap fetch--registryhttps://registry.npmmirror.com/这个命令会读取pnpm-lock.yaml然后从你指定的镜像源这里用了淘宝镜像速度更快把所有依赖包下载到airgap-packages文件夹里。这个过程可能需要几分钟因为依赖数量可能很多但只要做一次以后都可以复用。4. 获取pnpm-airgap本身的 CLI 工具新版关键步骤旧版教程中需要找bootstrap-publisher.js但在 2.x 版本中已经废弃。新版本只需要一个独立的cli.cjs文件。在外网项目目录或任意临时目录执行npmpack pnpm-airgaptar-xzfpnpm-airgap-*.tgz解压后在package文件夹里找到cli.cjs。这个文件就是全部 —— 它不依赖任何外部包只需要 Node.js 就能运行。请把这个cli.cjs文件和airgap-packages文件夹一起打包带走。5. 可选也下载 pnpm 本体如果内网机器完全没有 pnpm我们也可以把 pnpm 本身作为一个包带过去。在外网执行npmpackpnpm会生成一个pnpm-xxx.tgz文件这就是 pnpm 的离线安装包。把它也放进你的“行李”里。 打包并搬运将整个openclaw项目目录包括airgap-packages文件夹以及cli.cjs、pnpm-xxx.tgz一起压缩成一个.zip或.7z文件复制到 U 盘然后解压到内网 Windows 机器上。 第三部分最后的魔法 —— 本地仓库与离线安装新版‍♂️ 为什么需要一个“本地仓库”直接pnpm install --offline有时候会失败因为 pnpm 仍然期望通过http://registry.npmjs.org去检查包的元数据。我们可以在内网模拟一个极简的 npm 仓库把airgap-packages里的包“发布”到这个仓库里然后让 pnpm 把仓库地址指向它——就像在外网一样顺畅。 方案 A使用 Verdaccio推荐轻量级1. 在内网安装 Verdaccio虽然 Verdaccio 本身也需要网络安装但我们可以用同样的离线搬运技巧在外网执行npm pack verdaccio得到verdaccio-xxx.tgz。把.tgz搬到内网执行npm install -g verdaccio-xxx.tgz。或者你也可以直接用我们之前搬运的pnpm来全局安装 Verdaccio需要提前装好 pnpm。2. 启动 Verdaccioverdaccio保持这个窗口不关闭服务默认运行在http://localhost:4873。3. 使用cli.cjs发布所有依赖包打开另一个 cmd 窗口进入包含cli.cjs和airgap-packages的目录执行node cli.cjs publish -p ./airgap-packages -r http://localhost:4873这条命令会把airgap-packages里的所有包成百上千个全部发布到你本地的 Verdaccio 仓库中。这个过程只需要几秒钟。4. 配置 pnpm 使用本地仓库pnpm set registry http://localhost:48735. 运行pnpm installcd openclaw pnpm install现在 pnpm 会从你的本地仓库 (http://localhost:4873) 拉取所有依赖完全不需要互联网。 方案 B没有 Verdaccio 也能行极简模式如果你不想安装任何额外软件也可以用cli.cjs直接生成一个“文件仓库”。在内网执行node cli.cjs generate -p ./airgap-packages -o ./local-registry这会在local-registry文件夹里生成所有包的.tgz文件和一个简单的index.json。然后你可以配置 pnpm 直接从这个文件夹安装pnpm install --registry file:///D:/path/to/local-registry不过这种方式只适合单机测试不如 Verdaccio 稳定。 第四部分收尾 —— 构建 运行 OpenClaw1. 安装项目依赖如果上一步已经成功执行了pnpm install那么node_modules目录应该已经完整生成了。2. 构建 UI 和主项目pnpm ui:build pnpm build这些命令通常只是本地编译不依赖网络除非某些构建脚本会去下载额外的资源但 OpenClaw 不会。3. 链接 CLI可选如果你想在任意目录下使用openclaw命令pnpm link --global这会创建一个全局符号链接。4. 运行引导流程openclaw onboard --install-daemon现在你应该能看到 OpenClaw 的配置向导开始你的本地 AI 助手之旅了⚠️ 常见坑与避坑指南现象可能原因解决办法pnpm: command not found内网没有安装 pnpm用之前外网打包的pnpm-xxx.tgz离线安装npm install -g ./pnpm-xxx.tgzpnpm install卡住或报 404本地仓库没有正确启动或地址配置错误确保 Verdaccio 窗口一直运行并且pnpm get registry返回http://localhost:4873node cli.cjs publish报错Cannot find moduleNode.js 版本过低升级到 v18 以上或者检查cli.cjs是否完整它应该是单个文件约 5MB 大小构建时提示python或MSBuild缺失某些原生模块需要编译工具在外网下载Python 3.x安装包和Visual Studio Build Tools离线安装器同样搬运进来安装路径过长导致node_modules无法删除Windows 默认路径长度限制使用robocopy或 7-Zip 的“压缩后删除”功能或者启用 Windows 长路径支持组策略 最后的最后这份指南的精神离线开发并不可怕它只是把“即时下载”变成了“提前准备”。只要你理解了一个现代 Node.js 项目运行所需要的三要素Node.js 运行时—— 可以提前下载 .msi 安装包包管理器pnpm—— 可以提前打包成 .tgz项目依赖所有第三方包—— 可以用pnpm-airgap fetch一次性全抓下来然后利用一个本地仓库Verdaccio 或者cli.cjs generate生成的文件仓库就可以在内网复现和外网一模一样的开发体验。特别感谢pnpm-airgap的作者新版cli.cjs让离线发布变得无比简单 —— 不再需要什么bootstrap-publisher.js一个文件搞定所有。希望这篇文章能帮到每一个被困在内网却依然渴望敲代码、跑项目的你。如果觉得有用欢迎转发给你的同事 —— 独乐了不如众乐乐 Happy offline coding!—— 你的离线开发好伙伴以上就是修正后的完整博客。你可以直接用这个版本替换之前包含bootstrap-publisher.js的内容。如果还需要调整任何细节请随时告诉我。