2 OpenClaw安装与第一次启动
这一节我们把 OpenClaw 跑起来。新手不要一上来就配置所有渠道和工具，先完成最小闭环：安装、onboard、启动 Gateway、发出第一条消息。
1. 环境要求
根据官方 README，OpenClaw 推荐使用 Node 24，或者 Node 22.16 以上版本。它支持 macOS、Linux，以及 Windows 通过 WSL2 运行。Windows 原生环境也能探索，但如果你是第一次上手，WSL2 会更稳。
安装前准备：
- Node.js 24 或 Node.js 22.16+
- npm、pnpm 或 bun
- 一个可用的大模型账号或订阅
- 一个准备给 OpenClaw 使用的工作区目录
- 如果要接聊天平台，准备相应账号和授权
2. 推荐安装方式
官方推荐从 npm 安装：
npm install -g openclaw@latest
openclaw onboard --install-daemon
openclaw onboard 会引导你逐步设置 Gateway、workspace、channels 和 skills。--install-daemon 的意思是把 Gateway 装成常驻服务，让它在后台持续运行。
如果你使用 pnpm：
pnpm add -g openclaw@latest
openclaw onboard --install-daemon
3. 第一次启动Gateway
如果你想先手动启动，而不是马上做后台服务，可以运行：
openclaw gateway --port 18789 --verbose
这一步的目标是确认 Gateway 能正常启动。启动后先不要急着接入所有渠道，先看日志有没有模型认证、端口占用、配置缺失等错误。
4. 发送第一条消息
官方快速示例里有一个命令行发消息方式：
openclaw agent --message "Ship checklist" --thinking high
你也可以先用中文测试：
openclaw agent --message "请用中文说明你现在能做什么，先不要调用任何外部工具。" --thinking low
如果能收到稳定回复，说明模型调用链路已经通了。
5. 跑一次健康检查
完成安装后建议运行：
openclaw doctor
这个命令用于检查配置风险、环境缺失和常见错误。每次升级、迁移服务器、修改通道配置后，都建议跑一次。
6. 新手最小配置路线
建议按这个顺序配置：
- 只配置一个模型。
- 只配置一个聊天入口。
- 只允许一个自己可信的账号访问。
- 先做只读任务。
- 确认日志和回滚方式。
- 再逐步开放文件、浏览器、邮件、日历等工具。
这套顺序会慢一点，但更稳。AI 助手一旦接入真实账号，安全边界比功能数量更重要。
7. 常见问题
7.1 命令不存在
确认全局 npm 路径是否在 PATH 中：
npm bin -g
或者重新打开终端。
7.2 Gateway启动失败
常见原因：
- 端口被占用。
- Node 版本太低。
- 配置文件缺失。
- 模型认证信息错误。
先跑：
openclaw doctor
再看 Gateway 日志。
7.3 模型回复慢或不稳定
OpenClaw 是执行型助手，任务上下文通常比普通聊天更复杂。建议使用你信任的当前主力模型，不要用上下文太小、工具调用不稳定的模型做复杂任务。
8. 本节小结
这一节只追求一个目标：让 OpenClaw 能启动、能调用模型、能回复第一条消息。
下一节我们开始理解它真正的工作系统：通道、模型、记忆、技能和工具。