手动安装 OpenClaw

写在前面

这一步的目标不是一次把模型、平台、技能都配完，而是先建立一个最小可运行基线：

  • OpenClaw 已经安装；
  • Gateway 能正常启动；
  • 你知道怎样看状态和日志。

只要这三件事成立，后面接平台、改配置和装技能才有抓手。

第一步：先安装 OpenClaw

根据你的系统，先完成 CLI 安装。

macOS / Linux / WSL2

npm install -g openclaw@latest

如果你平时用 pnpm，也可以用：

pnpm add -g openclaw@latest

Windows PowerShell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://openclaw.ai/install.ps1 | iex

安装完成后，先确认命令已经可用：

openclaw --version

判断标准：

  • 如果能输出版本号，说明 CLI 已经装上；
  • 如果提示 command not found 或找不到 openclaw，先修好 PATH 或全局安装环境，再继续。

第二步：运行初始化向导

第一次安装后，直接运行：

openclaw onboard --install-daemon

这一步会帮你完成两件事：

  • 初始化基础配置；
  • 安装并启动 Gateway 后台服务。

新手建议：

  • 配置模式优先选 QuickStart；
  • 如果看到 Tools profile，优先保持 full；
  • 聊天渠道先跳过，后面单独接；
  • Skills、Hooks、搜索等附加能力先跳过。

判断标准：

  • 看到类似 Configuration saved、Gateway daemon installed and started，说明初始化基本成功；
  • 如果向导中断或启动失败，先不要继续接平台，先看日志。

第三步：立刻做最小验证

初始化结束后，不要先改配置，先做这三个检查。

1. 看运行状态

openclaw status

你要确认的是：

  • Gateway 处于运行状态；
  • 没有明显的启动失败提示；
  • 基础组件已经被识别。

如果你想做更深一点的检查，再跑：

openclaw status --deep

2. 看最近日志

openclaw logs --limit 100

如果你要实时观察启动过程，用：

openclaw logs --follow

你要重点看的是：

  • 有没有连续重复的报错；
  • 有没有模型配置、权限、路径或端口占用错误；
  • 日志是否显示 Gateway 已经正常启动。

3. 需要时做一次诊断

openclaw doctor

如果你想先看建议再修，先用这个；如果你已经明确要让它自动尝试修复，再考虑：

openclaw doctor --fix

第四步：确认 Tools Profile 不是 messaging

如果你后面发现 OpenClaw 只会给建议、不会真正执行文件和命令操作，通常是 tools.profile 没开成 full。

直接检查并修复：

openclaw config set tools.profile full
openclaw gateway restart

修复后再做一次最小验证：

openclaw status
openclaw logs --limit 50

判断标准：

  • 配置修改后 Gateway 能正常重启；
  • 后续在聊天或 CLI 中，OpenClaw 不再只停留在“给建议”。

第五步：记住后面排错一定会用到的入口

安装阶段先把下面这些命令记住，后面几乎都会反复用到：

openclaw status
openclaw status --deep
openclaw logs --follow
openclaw gateway restart
openclaw configure
openclaw config file
openclaw config validate

如果你以后改完配置，不确定有没有生效，优先走这条顺序：

  1. openclaw config validate
  2. openclaw gateway restart
  3. openclaw status
  4. openclaw logs --follow

常见错误或风险

  • 不要一开始就同时配置模型、平台、技能和自动化；
  • 不要只看到安装命令跑完，就默认整个系统已经可用；
  • 如果日志里已经持续报错，就不要继续往后看平台接入页；
  • 如果是长期运行场景，后面应尽早进入部署页，把服务放到稳定的后台环境里。

下一步

如果你已经完成安装并确认 Gateway 正常运行，继续看 接入第一个聊天平台。

如果你想把 OpenClaw 放到服务器上长期运行，再去看部署相关内容，而不是在这篇里继续堆配置。