内网 Windows 极客指南从零跑起 OpenClaw 离线开发环境没有互联网也能优雅地装上 Node.js、pnpm 和整个 OpenClaw 项目—— 一份写给小白、也写给所有爱折腾的人的离线部署手记你是否遇到过这种情景公司的开发机在纯内网不能连外网但你却想从 GitHub 上 clone 一个酷炫的项目比如OpenClaw来跑起来、改代码、甚至成为贡献者或者你只是想在一台完全离线的 Windows 电脑上把一套现代前端/Node.js 项目完整运行起来别怕。离线 ≠ 绝路。今天这篇文章我会带你一步一步像蚂蚁搬家一样从外网把需要的“干粮”全都搬到内网最后在你的 Windows 机器上跑起pnpm install和openclaw onboard。全文分为四个部分搬家的第一件行李 —— 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这个命令会读取pnpm-lock.yaml然后从 npm 官方仓库把所有需要的.tgz包下载到airgap-packages文件夹里。这个过程可能需要几分钟因为依赖数量可能很多但只要做一次以后都可以复用。4. 可选也下载 pnpm 本体如果内网机器完全没有 pnpm我们也可以把 pnpm 本身作为一个包带过去。在外网执行npmpackpnpm会生成一个pnpm-xxx.tgz文件这就是 pnpm 的离线安装包。 打包并搬运将整个openclaw项目目录包括airgap-packages文件夹压缩成一个.zip或.7z文件复制到 U 盘然后解压到内网 Windows 机器上。 第三部分最后的魔法 —— 本地仓库与离线安装‍♂️ 为什么需要一个“本地仓库”直接pnpm install --offline有时候会失败因为 pnpm 仍然期望通过http://registry.npmjs.org去检查包的元数据。我们可以在内网模拟一个极简的 npm 仓库把airgap-packages里的包“发布”到这个仓库里然后让 pnpm 把仓库地址指向它——就像在外网一样顺畅。✨ 方案 A使用 pnpm-airgap 自带的“零依赖发布工具”最推荐pnpm-airgap包里藏着一个神奇的小脚本bootstrap-publisher.js它不需要额外安装任何软件只需要 Node.js 就能启动一个简单的仓库。在外网找到这个脚本bootstrap-publisher.js一般位于全局安装的 pnpm-airgap 目录下Linux/macOS~/.npm/node_modules/lib/node_modules/pnpm-airgap/lib/bootstrap-publisher.js或者在当前项目的node_modules/pnpm-airgap/lib/里如果你之前在外网项目里执行过pnpm install。把这个.js文件也复制到 U 盘里和内网的项目文件放在一起。在内网 Windows 上执行发布命令打开 cmd进入项目目录运行node path\to\bootstrap-publisher.js airgap-packages http://localhost:4873解释一下airgap-packages是存放所有依赖包的文件夹路径。http://localhost:4873是这个临时仓库的地址端口可以换4873 是 Verdaccio 的默认端口。运行之后终端会显示Registry started at http://localhost:4873不要关掉这个窗口它就是一个正在运行的本地仓库。配置 pnpm 使用这个本地仓库新开一个 cmd 窗口执行pnpm set registry http://localhost:4873这样 pnpm 以后就会从你的本地仓库去下载依赖。运行 pnpm installcd openclaw pnpm install这时候 pnpm 会去http://localhost:4873拉取所有包而你的本地仓库已经通过bootstrap-publisher.js提供了这些包所以完全不依赖外网速度飞快 方案 B搬运完整的 Verdaccio适合长期团队如果你希望有一个更“正式”的私有 npm 仓库可以搬运 Verdaccio。方法也很简单在外网任意目录执行npm install verdaccio得到一个node_modules\verdaccio文件夹。把这个文件夹整个拷贝到内网。在内网运行npx verdaccio它会启动一个仓库默认地址也是http://localhost:4873。记得修改配置文件config.yaml删掉所有uplinks配置防止它试图联网代理。不过对于个人或小团队方案 A 已经足够优雅。 第四部分收尾 —— 构建 运行 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本地仓库没有正确启动或地址配置错误确保bootstrap-publisher.js窗口一直运行并且pnpm get registry返回http://localhost:4873构建时提示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一次性全抓下来然后利用一个本地仓库哪怕只有几行 Node.js 代码的bootstrap-publisher.js就可以在内网复现和外网几乎一模一样的开发体验。希望这篇文章能帮到每一个被困在内网却依然渴望敲代码、跑项目的你。如果觉得有用欢迎转发给你的同事 —— 独乐了不如众乐乐 Happy offline coding!—— 你的离线开发好伙伴