前言

最近在尝试部署 OpenClaw（一个开源 AI 助手工具），踩了无数坑——从 npm 安装的权限/依赖报错，到交互式初始化向导的「无光标」「没反应」，再到启动命令不存在…… 本文结合实际操作，完整记录从 0 到 1 的部署流程，帮你避开所有坑，小白也能一次跑通！

 一、安装前准备：确保 Node.js 环境就绪

OpenClaw 依赖 Node.js 运行，先确认你的环境：

node -v
npm -v

- 要求：Node.js 版本 ≥ 18（推荐 20+），npm 版本 ≥ 8；

- 如果没安装，直接执行 `winget install OpenJS.NodeJS` 一键安装，重启终端即可。

 二、核心安装：解决 npm 所有报错（重点避坑）

1. 安装命令（最终版）

npm install -g openclaw@latest --omit=optional --ignore-scripts

- `--omit=optional`：跳过问题依赖 `node-llama-cpp`（避免预编译二进制包下载失败）；

- `--ignore-scripts`：忽略所有 postinstall 脚本（解决 `EPERM: operation not permitted` 权限报错）；

- `git config --global url."https://github.com/".insteadOf ssh://git@github.com/`：提前配置 git，避免 SSH 权限问题。

2. 常见报错与解决（结合截图）

| 报错截图 | 核心原因 | 解决办法 |

|----------|----------|----------|

| `EPERM: operation not permitted, rmdir` | npm 清理旧文件时权限不足 | 用管理员身份打开 PowerShell，或执行 `npm cache clean --force` 后重新安装 |

| `node-llama-cpp: A prebuilt binary was not found` | 可选依赖的 postinstall 脚本仍在执行 | 必须加上 `--omit=optional --ignore-scripts`，彻底掐断这个依赖的执行逻辑 |

| `git clone ssh://git@github.com... Permission denied` | git 默认使用 SSH 协议，无权限 | 执行 `git config --global url."https://github.com/".insteadOf ssh://git@github.com/`，强制用 HTTPS 克隆 | ---

三、初始化向导：交互式界面操作（解决「没反应」问题）

安装完成后，执行 `openclaw onboard --install-daemon` 启动初始化向导，全程是交互式选择界面（无光标，用方向键/空格键操作），以下是关键步骤的避坑操作：

1. 安全警告：直接输入 `Yes` 按回车

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
Yes / No

- 输入 `Yes`，确认个人使用场景，继续向导。

2. 模型/认证配置：选择 `Keep current`

- 界面会让你选择模型，**直接按回车** 选择 `Keep current (default: anthropic/claude-opus-4-6)`，跳过手动选择；

- 无需准备 API Key，先跑通环境，之后可通过 `openclaw config` 补配置。

3. 聊天频道/技能/钩子配置：选择 `Skip for now`

- 这几个环节都可以**暂时跳过**，重点是「至少选一个选项」；

- 关键坑点：`Skip for now` 视觉上显示 `[•]`，但系统可能没识别到，需要：

1. 按「空格键」重新选中（`[ ]` → `[•]`）；

2. 再按「回车键」提交，否则会提示「Please select at least one option」没反应。

-四、启动与验证：解决 `start` 命令不存在问题

1. 报错：`error: unknown command 'start'`

初始化完成后，执行 `openclaw start` 会报错：

``` error: unknown command 'start' (Did you mean status?) ```

- 核心原因：新版 OpenClaw 初始化后，网关服务已自动启动（终端提示 `Onboarding complete. Dashboard opened` 就是证据），`start` 命令已被移除；

- 解决办法：不需要手动启动，直接用 `openclaw status` 查看状态。

2. 验证服务状态（`openclaw status` 输出解读） 从你的截图可以看到：

- ✅ **Dashboard 地址**：`http://127.0.0.1:18789/`（直接在浏览器打开即可使用）；

- ✅ **Gateway 可访问**：`reachable 29ms`，服务在后台稳定运行；

- ✅ **配置文件已生成**：`~\.openclaw\openclaw.json`，默认模型已配置；

- ⚠️ **安全警告**：提示 `Reverse proxy headers are not trusted`，是因为当前是本地回环地址，**个人使用完全安全**，无需修改。 ---

五、最终使用：直接访问 Dashboard

1. 打开 OpenClaw 控制面板

复制下面这个地址，粘贴到浏览器地址栏并按回车：

``` http://127.0.0.1:18789/ ```

- 这个页面就是 OpenClaw 的**可视化控制面板（Dashboard）**，你可以在网页里直接和 OpenClaw 对话、管理配置、查看会话记录；

- 全程无需再执行任何命令，小白友好度拉满！

2. 核心操作（Dashboard 里的功能）

和 OpenClaw 对话：在聊天框输入问题，调用默认模型（`anthropic/claude-opus-4-6`）生成回复；

- **修改配置**：点击「Settings」按钮，重新配置模型、认证、技能等；

- **查看状态**：Dashboard 实时显示服务状态、会话数量、内存使用等信息。

六、总结与后续使用

1. 已完成的成果

- ✅ 解决了 npm 安装的所有权限/依赖/SSH 问题；

- ✅ 跳过了复杂的配置，先跑通了 OpenClaw 环境；

- ✅ 服务已在后台稳定运行，Dashboard 已就绪，可直接在网页版使用。

2. 后续常用命令（按需使用）

| 命令 | 作用 |

|------|------|

| `openclaw status` | 查看当前服务运行状态 |

| `openclaw config` | 重新打开初始化向导，修改配置 |

| `openclaw stop` | 停止 OpenClaw 网关服务 |

| `openclaw update` | 更新 OpenClaw 到最新版本 | ---

七、结尾

本文完整记录了 Windows 下 OpenClaw 从 0 到 1 的部署流程，结合真实操作，帮你避开了所有常见坑点——从安装到初始化，再到最终使用，小白也能一次跑通！ 如果你也在尝试部署 OpenClaw，欢迎在评论区交流踩坑经验～ 🚀

--- **资源链接**：

- OpenClaw 官方文档：https://docs.openclaw.ai/

- 常见问题 FAQ：https://docs.openclaw.ai/faq

- 故障排查指南：https://docs.openclaw.ai/troubleshooting