OpenClaw Windows 安装部署手册 本手册基于实际安装经验编写，将每一步可能遇到的典型错误及解决办法直接嵌入操作流程中，帮助你顺利部署 OpenClaw。
建议全程以 管理员身份 运行 PowerShell（右键点击 PowerShell 图标 → “以管理员身份运行”），以避免权限问题。

---

📑 目录

1. 环境准备

2. 安装 OpenClaw

3. 初始化配置

4. 启动网关服务

5. 访问控制面板

6. 常用命令速查

---

一、环境准备

1.1 必需软件

软件	版本要求	下载链接 / 安装注意事项
Node.js	22+	https://nodejs.org – 安装时务必勾选 “Add to PATH”
Git	最新版	https://git-scm.com/download/win – 选择 “Add Git to PATH” 和 “Use Git from the Windows Command Prompt”
Visual C++ Redistributable	最新版	https://aka.ms/vs/17/release/vc_redist.x64.exe – 某些精简版 Windows 缺少此组件，可能导致 Node.js 插件运行失败

1.2 验证安装

打开 PowerShell，执行以下命令确认：

node --version   # 应输出 v22.x.x 以上
git --version    # 应输出 git version 2.x.x

❗ 常见错误与解决（环境准备阶段）

错误现象	原因	解决办法
git : 无法将“git”项识别为 cmdlet	Git 未安装或未加入 PATH	重新安装 Git，并确保勾选“Add Git to PATH”
npm : 无法加载文件 ...\npm.ps1，因为在此系统上禁止运行脚本	PowerShell 执行策略为 Restricted	以管理员身份运行 PowerShell，执行： Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 输入 Y 确认。

---

二、安装 OpenClaw

2.1 配置 npm 国内镜像（加速下载，避免网络问题）

npm config set registry https://registry.npmmirror.com/

2.2 安装 cnpm（解决 npm 安装时可能出现的 code 128 错误）

npm install -g cnpm --registry=https://registry.npmmirror.com/

2.3 使用 cnpm 安装 OpenClaw

cnpm install -g openclaw@latest

成功标志：最后显示 openclaw@2026.3.13 等版本信息。

❗ 常见错误与解决（安装阶段）

错误现象	原因	解决办法
npm error code 128	Git 未正确安装或无法访问 GitHub 仓库	① 确认 git --version 正常；② 已配置 npm 镜像；③ 改用 cnpm 安装（见步骤 2.2）。
cnpm : 无法将“cnpm”项识别为 cmdlet	cnpm 未安装或未加入 PATH	重新执行 cnpm 安装命令，安装后关闭并重新打开 PowerShell。

---

三、初始化配置（onboard）

3.1 执行配置向导

openclaw onboard --install-daemon

• 阅读安全提示，输入 Yes 确认。

• 模式选择 QuickStart（推荐）。

• 模型提供商：可按需选择（如 OpenAI、Skip for now），若跳过后续可再配置。

• 频道配置：首次使用建议选择 Skip for now。

配置过程中会生成一个带 Token 的 Dashboard 链接，形如：

http://127.0.0.1:18789/#token=28b46cf38f508947b98753792369b0082385bc0e3b5aca22

此链接会自动在浏览器中打开，请保留该标签页以便后续控制。

❗ 常见错误与解决（初始化阶段）

错误现象	原因	解决办法
Gateway service install failed: Error: schtasks create failed: 拒绝访问	安装网关服务需要管理员权限	以管理员身份重新运行 PowerShell，然后继续 第四章 的手动安装。
openclaw : 无法加载文件 ...\openclaw.ps1...	PowerShell 执行策略未修改	按 1.2 节 中的方法修改执行策略。

---

四、启动网关服务

4.1 安装网关服务（必须以管理员身份运行 PowerShell）

openclaw gateway install

成功提示：Installed Scheduled Task: OpenClaw Gateway

4.2 启动网关

openclaw gateway start

成功提示：Restarted Scheduled Task: OpenClaw Gateway

4.3 验证服务状态

openclaw status

输出中 Gateway 项应显示 reachable，且 Gateway service 状态正常。

4.4 测试访问

curl http://127.0.0.1:18789

应返回 HTML 内容（非连接错误），说明服务运行正常。

❗ 常见错误与解决（网关服务阶段）

错误现象	原因	解决办法
Gateway service missing	网关服务未安装	执行 openclaw gateway install（需管理员权限）
Gateway install failed: 拒绝访问	当前PowerShell 无管理员权限	右键 → 以管理员身份运行 PowerShell，再执行安装。
curl: (7) Failed to connect to 127.0.0.1 port 18789	网关服务未启动或端口未监听	① 执行 openclaw gateway start；② 检查端口：netstat -ano | findstr :18789 应有输出；③ 查看日志：openclaw logs。
Gateway unreachable (connect ECONNREFUSED)	服务未运行	同上一项。

---

五、访问控制面板

直接使用 onboarding 生成的带 Token 的 URL 访问：

http://127.0.0.1:18789/#token=你的令牌

也可随时通过以下命令重新获取并打开：

openclaw dashboard

❗ 常见错误与解决（访问阶段）

错误现象	原因	解决办法
unauthorized: gateway token missing	访问缺少Token	使用 openclaw dashboard 命令打开的链接，或手动在页面设置中输入 Token（Token 可在 C:\Users\用户名\.openclaw\openclaw.json 的 gateway.auth.token 中找到）。

---

六、常用命令速查

命令	说明
openclaw --version	查看版本
openclaw status	查看整体状态
openclaw gateway install	安装网关服务（需管理员）
openclaw gateway start	启动网关
openclaw gateway stop	停止网关
openclaw gateway uninstall	卸载网关服务
openclaw dashboard	打开控制面板（带 Token）
openclaw logs	查看运行日志
openclaw doctor --fix	自动诊断并修复常见问题