Windows 平台从 0 到 1 部署 OpenClaw CN：真实踩坑记录
为什么选择 OpenClaw？
LLM 和 AI Agent 发展太猛了，新闻天天刷屏，OpenClaw登顶GitHub软件星标历史第一，已超越Linux。按捺不住想亲手试试。在 Gitee 上看到 OpenClaw CN 排在靠前位置，果断开搞！
最终选择 OpenClaw CN（OpenClaw 的中国本土化版本），原因很简单：
- 🇨🇳 国产模型支持：内置 DeepSeek-V3 / Qwen，不用花大价钱买 Claude
- 🛡️ 本地部署：数据在自己机器上，隐私可控
- 🔌 多平台连接：支持微信、飞书、钉钉等国内生态
- ⚡ 安装友好：有中文文档和保姆级教程
环境准备
系统要求：
- Windows 10/11
- Node.js ≥ 22（我用的 v22.22.0）
- pnpm（强制推荐，国内镜像源）
# 安装 Node.js 22（我用 nvm 管理版本）
nvm install 22
nvm use 22
# 验证版本
node -v # v22.22.0
# 安装 pnpm（如果还没装）
npm install -g pnpm
# 配置淘宝镜像（关键！否则下载慢到怀疑人生）
pnpm config set registry https://registry.npmmirror.com/
部署步骤
1. 克隆仓库
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn
2. 安装依赖
pnpm install
耗时： 约 13 分钟（970 个包，下载了 node-llama-cpp、pdfjs-dist 等大文件）
3. 构建 UI 和项目
pnpm ui:build
pnpm build
4. 初始化向导（最关键的一步）
pnpm openclaw onboard --install-daemon
这一步会引导你：
- 确认安全警告（OpenClaw 能读写文件、执行命令，需谨慎）
- 选择 AI 模型提供商（我选的 Qwen，OAuth 认证）
- 配置默认模型
- 安装 Windows 计划任务服务
- 配置技能依赖
5. 启动网关
pnpm openclaw gateway
6. 打开管理界面
pnpm openclaw dashboard
浏览器访问：http://127.0.0.1:*****/#token=xxx（带认证 token）
遇到的坑与解决方案（真实踩坑记录）
坑 1：nvm 命令不识别 — 根本没安装 nvm-windows
真实错误日志：
PS <你的盘符>:> nvm install 22
nvm : 无法将"nvm"项识别为 cmdlet、函数、脚本文件或可运行程序的名称。
所在位置 行:1 字符: 1
+ nvm install 22
+ ~~~
+ CategoryInfo : ObjectNotFound: (nvm:String) [], CommandNotFoundException
原因分析：
- Windows 系统没有自带 nvm，需要单独安装 nvm-windows
- 系统原有的 Node.js v16 太老，需要升级
完整解决步骤：
-
卸载原有 Node.js（必须！否则 nvm 无法工作）
- 控制面板 → 程序和功能 → 找到 Node.js → 卸载
- 重启电脑
-
下载 nvm-windows
- 官方地址：github.com/coreybutler…
- 下载
nvm-setup.exe（图形化安装，自动配置环境变量） - ⚠️ 如果跳转到 VirusTotal 扫描页面，直接忽略，这是误报
-
安装 nvm
- 双击 nvm-setup.exe，全程默认下一步
- 安装路径不要有中文、空格
-
重启终端并验证
nvm version # 出现版本号说明安装成功 -
安装 Node.js 22
nvm install 22 nvm use 22 node -v # v22.22.0 npm -v # 10.9.4
坑 2：PowerShell 执行策略阻止 npm.ps1 运行
真实错误日志：
PS C:\Users<你的用户名>> npm install -g pnpm
npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1。
未对文件 C:\Program Files\nodejs\npm.ps1 进行数字签名。
无法在当前系统上运行该脚本。
CategoryInfo : SecurityError: (:) []，PSSecurityException
原因分析： Windows PowerShell 默认安全策略阻止未签名脚本运行。
解决（10 秒搞定）：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# 提示时输入 Y 确认
然后再安装 pnpm：
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com/
坑 3：pnpm build 失败 — bash 脚本 Windows 不兼容
真实错误日志：
<你的工作目录>\openclaw-cn> pnpm build
> bash scripts/bundle-a2ui.sh
??? Linux ? Windows
ELIFECYCLE Command failed with exit code 1.
原因分析： 构建脚本调用了 bash 命令，Windows 原生 PowerShell 不支持。
解决：
-
方案 A（推荐）： 安装 WSL2
wsl --install # 重启电脑后在 WSL2 环境中运行 -
方案 B： 跳过 build，直接运行 onboard（会自动处理构建）
pnpm openclaw onboard --install-daemon
我选择方案 B，继续执行 onboard 成功完成配置。
坑 4：onboard 向导配置 — 不知道每个步骤该干啥
真实场景： 运行 onboard 后出现一堆选项，完全懵逼：
- QuickStart 是什么？
- Channel 要配置吗？
- Skills 要不要装？
- 怎么跳过？
配置流程（亲测可用）：
- 安全警告 → 选
Yes（确认理解风险） - Onboarding 模式 → 选
QuickStart（快速配置） - 模型提供商 → 选
Qwen（OAuth 扫码登录，不用 API Key） - 默认模型 → 保持
qwen-portal/coder-model - Channel 配置 → 选
Skip for now（新手跳过，后续在 Web 界面配置） - 技能配置 → 选
Yes（启用基础技能） - 技能依赖安装 → 选
Skip for now（38 个依赖缺失，Windows 大部分装不了） - 包管理器 → 选
npm（默认即可）
关键提示：
- 技能依赖失败不用管（go、brew、uv 等 Windows 没有）
- 核心功能（聊天、文件管理、网页搜索）不受影响
- 需要特定技能时再单独安装依赖
坑 5：Windows 计划任务创建失败 — 权限不足
真实错误日志：
Gateway service install failed: schtasks create failed: 拒绝访问。
Tip: rerun from an elevated PowerShell (Start → type PowerShell → right-click → Run as administrator)
原因分析： 安装程序试图创建 Windows 计划任务（开机自启），但没有管理员权限。
解决：
-
以管理员身份运行 PowerShell
- Win + S 搜索 PowerShell → 右键 → 以管理员身份运行
-
重新执行安装
cd <你的工作目录>\openclaw-cn pnpm openclaw onboard --install-daemon -
或者跳过服务安装（临时方案）
- 不影响使用，只是不能开机自启
- 每次手动运行：
pnpm openclaw gateway
坑 6：openclaw 命令找不到 — 不是全局安装
真实错误日志：
<你的工作目录>\openclaw-cn> openclaw dashboard
'openclaw' 不是内部或外部命令，也不是可运行的程序或批处理文件。
原因分析： OpenClaw 从源码构建，没有全局安装到 PATH。
解决： 所有命令前加 pnpm：
pnpm openclaw dashboard
pnpm openclaw gateway
pnpm openclaw status
pnpm openclaw doctor
永久方案（可选）： 创建 PowerShell 别名
# 在 PowerShell profile 中添加
Set-Alias openclaw "pnpm openclaw"
坑 7：网关启动成功但浏览器访问被拒绝
真实场景：
<你的工作目录>\openclaw-cn> pnpm openclaw dashboard
Dashboard URL: http://127.0.0.1:PORT/#token=<your-token>
Opened in your browser.
但浏览器显示： "127.0.0.1 拒绝了我们的连接请求"
原因分析： dashboard 命令只打开浏览器，不自动启动网关。
解决步骤：
-
手动启动网关（保持终端不关闭）
cd <你的工作目录>\openclaw-cn pnpm openclaw gateway -
检查端口是否监听
netstat -ano | findstr PORT # 应该看到 LISTENING 状态 -
访问 Web 界面
http://127.0.0.1:PORT/#token=<your-token>
成功标志： 看到熟悉的聊天界面，可以开始对话了！🎉
最终成功日志
🦞 OpenClaw 2026.2.23-cn
Dashboard URL: http://127.0.0.1:PORT/#token=<your-token>
Copied to clipboard. Opened in your browser.
Keep that tab to control OpenClaw.
打开浏览器，看到熟悉的聊天界面，部署成功！
使用体验
部署完成后，我的使用场景：
- Web 界面随时对话：通过
http://127.0.0.1:*****随时提问 - 文件管理：让它帮我整理工作区文件、读取文档
- 信息搜索：直接让它查资料、总结网页内容
- 记忆系统：它会记住重要的事，写到
MEMORY.md里
性能表现：
- 启动时间：约 3-5 秒
- 响应速度：Qwen coder-model 约 2-4 秒出首字
- 资源占用：空闲时约 200MB 内存，运行时 500MB+
参考链接：
- OpenClaw CN 文档：open-claw.org.cn
- 源码仓库：gitee.com/OpenClaw-CN…
- Qwen 开放平台：chat.qwen.ai/
- WSL2 安装指南：learn.microsoft.com/zh-cn/windo…
- nvm-windows 下载：github.com/coreybutler…
