5. 安装 OpenClaw：CLI 与 onboard 向导

本节目标：照着做，你能在本机装上 OpenClaw 命令行，跑完初始化引导，并打开网页控制台。读完即可拥有一个待命的网关。

安装分三步走

装 OpenClaw 其实就三件事：装命令行、跑引导、开控制台。

顺序别乱。先装 CLI，再引导，最后开界面看效果。

Note

本章只装”本体”和”守护进程”。模型怎么接、渠道怎么连，留到后续章节。先让网关跑起来最重要。

确认 Node 达标后（见第 4 章），在终端执行：

npm install -g openclaw@latest

这条命令从 npm 拉取最新版（2026.7.1-2），装成全局命令 openclaw。

装完验证一下：

openclaw --version

能打印出版本号，说明 CLI 就位了。

Tip

如果你更想要一键脚本，官方也提供 https://openclaw.ai/install.sh。但本教程以 npm 命令为准，它更透明、更好排错。

CLI 装好，接着初始化。推荐一条命令到底：

openclaw onboard --install-daemon

--install-daemon 会顺手把网关注册成系统服务，开机自启也一并安排（第 6 章细讲）。

引导过程会问你几件事，核心就两件：

Note

引导坚持”先验证再继续”。某个候选模型不通，它会悄悄试下一个，只把真正可用的那条写进配置。失败的不会被保存。

中途想重来，随时：

openclaw onboard --reset

这会把状态清空再走一遍，不破坏已装好的本体。

引导成功后，打开网页控制台：

openclaw dashboard

它会在浏览器打开 http://127.0.0.1:18789/。这就是你平时和助手对话、看状态的地方。

如果浏览器没自动跳，手动访问上面的地址即可。回环地址默认带令牌保护，按提示粘贴引导生成的令牌。

跑三条命令兜底：

openclaw --version      # CLI 可用
openclaw doctor         # 检查配置问题
openclaw gateway status # 网关在跑吗

doctor 会扫出常见配置毛病，按提示修就行。

Tip

第一次装完，先在控制台随便聊两句。能回，说明链路通了；回不了，先看 gateway status 是否健康。

命令找不到。多为 npm 全局 bin 没进 PATH（第 4 章末尾提过）。重开终端，或把 bin 目录加进环境变量。

引导卡在选模型。先确认 API Key 没填错、网络能连到模型服务商。也可以选 “Skip for now” 跳过，之后再跑 openclaw onboard 补。

想从头来。用 --reset，别手删配置目录，容易留半截状态。

到这里，你的机器上有：

下一章讲清楚：前台运行和守护进程差在哪，开机自启怎么来的，怎么确认它真的在跑。