在 Windows 上安装 OpenClaw 详细教程

这篇是从“能安装”升级到“能稳定使用”的完整教程。
重点补充：OpenClaw 中间配置步骤（模型、网关、浏览器接入、验证）全部细化到可直接照做。

---

一、适合人群与阅读收益

适合人群：

• 第一次在 Windows 上搭 OpenClaw 的同学
• 安装过但经常报错、状态不稳定的同学
• 想要一份“每一步都知道为什么做”的实操文档

看完你能得到：

1. 完成 OpenClaw 安装与验证
2. 完成 OpenClaw 中间配置（核心）
3. 正确启动并管理 Gateway
4. 接入 Chrome Relay 并验证网页能力
5. 遇到报错能快速定位与修复

---

二、背景与目标

OpenClaw 不是单纯聊天工具，而是“可执行工具链”的 Agent 运行环境。

所以你要搭建的不只是一个命令，而是一条完整链路：

• 环境准备（Node/npm）
• OpenClaw 安装
• OpenClaw 中间配置（模型与运行设置）
• Gateway 服务启动
• 浏览器 Relay 接入
• 回归验证

---

三、环境准备 / 前置条件

1）系统要求

• Windows 10/11（建议 64 位）
• PowerShell（建议先以管理员打开一次）
• Google Chrome（后续用于 Relay）

2）Node/npm 检查

执行：

node -v
npm -v
where node
where npm

预期结果：

• node -v 有版本号（建议 v20+）
• npm -v 有版本号
• where node / where npm 返回路径

错误结果：

• 提示命令不存在
• 路径有多个且混乱

解决办法：

• 重装 Node.js LTS（官方安装包）
• 重新打开终端再检查

---

四、分步骤实操（含 OpenClaw 中间设置）

第 1 步：安装 OpenClaw

操作命令：

npm install -g openclaw

预期结果：

• 安装成功结束
• 无权限中断报错

错误结果与处理：

• npm ERR! code EACCES → 权限问题，建议修复 Node/npm 环境后重装

---

第 2 步：验证 OpenClaw 命令是否可用

操作命令：

openclaw --version
openclaw help

预期结果：

• 输出版本号
• 输出 help 子命令列表

错误结果与处理：

• openclaw 无法识别 → PATH 未生效，检查 npm 全局路径并重开终端

---

第 3 步：OpenClaw 中间设置（重点）

这一段是很多教程缺失的核心部分。

3.1 检查当前总体状态

执行：

openclaw status

预期结果：

• 能看到当前运行信息（服务/会话/模型相关状态）

3.2 设置或确认模型来源（如果你的环境需要）

说明：

• 部分环境会要求你先完成模型 provider 配置，否则只能启动但不可正常对话。
• 若你已有默认模型，可跳过；若没有，按引导配置。

建议动作：

1. 先执行 openclaw status 看是否存在可用模型
2. 如果无可用模型，按你环境的 OpenClaw 引导完成 provider/model 配置
3. 配完后再次执行 openclaw status 复核

预期结果：

• 状态中可见可用模型信息

错误结果：

• 后续会话提示模型不可用/无默认模型

解决办法：

• 补齐 provider、base url、api key、model id
• 配置后重启 gateway 再验证

3.3 网关配置生效（关键）

执行：

openclaw gateway restart
openclaw gateway status

预期结果：

• restart 成功
• status 显示运行中

错误结果：

• restart 后仍失败

解决办法：

• 回查 Node 版本与 PATH
• 再次执行 restart + status

---

第 4 步：启动并验证 Gateway 服务

执行：

openclaw gateway status
openclaw gateway start
openclaw gateway status

预期结果：

• 由未运行变为运行中

错误结果：

• 启动后立即退出

原因与解决：

• 常见是环境不兼容或配置未生效 → 先 openclaw gateway restart，再复核配置

---

第 5 步：连接 Chrome Relay

操作步骤（每一步都要做）：

1. 打开 Chrome，安装并启用 OpenClaw Browser Relay 扩展
2. 打开目标网页（比如你要自动化操作的页面）
3. 点击扩展图标，让当前 tab 状态变为 ON/已连接
4. 保持该 tab 不要切到无关页面再执行操作

预期结果：

• 可执行截图、DOM 采样、页面交互

错误结果：

• Chrome extension relay is running, but no tab is connected

原因：

• 服务正常，但目标 tab 没附着

解决办法：

• 回到目标 tab 再点一次扩展图标连接

---

第 6 步：做一次端到端回归验证

建议最小验证链路：

1. 执行 openclaw status
2. 执行一次浏览器截图
3. 再执行一次页面结构采样

预期结果：

• 状态正常
• 截图成功
• DOM 采样成功

如果这三步都成功，说明安装 + 中间设置 + 服务 + 接入都打通了。

---

五、常见报错与排查（增强版）

报错 A：openclaw 命令无法识别

• 现象：openclaw 无法识别
• 原因：PATH 未生效
• 解决：检查 npm 全局路径、重开终端
• 正确结果：openclaw --version 返回版本

报错 B：gateway 反复启动失败

• 现象：start 后仍不可用
• 原因：Node 版本/配置不一致
• 解决：统一 Node 版本，gateway restart 后再看 status
• 正确结果：status 显示运行中

报错 C：Relay 未连接

• 现象：no tab connected
• 原因：tab 未附着
• 解决：目标 tab 点击扩展连接
• 正确结果：截图/采样可执行

---

六、最佳实践 / 避坑建议

• 先搭最小闭环，再做复杂任务
• 每次改配置后都 restart gateway
• 始终按“环境→服务→接入→验证”的顺序排查
• 保留一份你自己的排错清单，后续提效非常明显

---

七、总结与下一步建议

你这次真正需要记住的是：
OpenClaw 能稳定使用，关键不在安装命令，而在中间配置是否做完整。

下一步建议：

1. 固化你的本机标准流程文档
2. 固化回归检查（status + screenshot + snapshot）
3. 后续扩展新能力前，先跑一遍最小验证链路

这样你的环境会长期稳定，不会每次从头排错。