2 OpenClaw安装与第一次启动

先把 OpenClaw 跑起来。新手不要一上来就配置所有渠道和工具，先完成最小闭环：安装、onboard、启动 Gateway、发出第一条消息。

查看大图

安装 OpenClaw 时，我更看重第一轮检查能不能复现。能启动一次不够，要知道配置在哪、日志在哪、错误怎么查、重启后是否还正常。

查看大图

第一次启动后不要急着接很多平台，先只保留一个消息入口和一个模型。最小闭环稳定后，再加记忆、技能和工作流。

查看大图

1. 环境要求

根据官方 README，OpenClaw 推荐使用 Node 24，或者 Node 22.16 以上版本。它支持 macOS、Linux，以及 Windows 通过 WSL2 运行。Windows 原生环境也能探索，但如果你是第一次上手，WSL2 会更稳。

查看大图

安装 OpenClaw 后，不要只看程序是否打开。用一个最小任务确认配置、工具调用、日志和输出结果，后续扩展才有基础。

安装前准备：

• Node.js 24 或 Node.js 22.16+
• npm、pnpm 或 bun
• 一个可用的大模型账号或订阅
• 一个准备给 OpenClaw 使用的工作区目录
• 如果要接聊天平台，准备相应账号和授权

2. 推荐安装方式

官方推荐从 npm 安装：

查看大图

读《OpenClaw安装与第一次启动》时，可以先看配图里的任务、概念、练习和判断点，再回到正文补细节。这样更容易判断这篇内容能放到哪个真实场景里。

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. 新手最小配置路线

建议按这个顺序配置：

查看大图

1. 只配置一个模型。
2. 只配置一个聊天入口。
3. 只允许一个自己可信的账号访问。
4. 先做只读任务。
5. 确认日志和回滚方式。
6. 再逐步开放文件、浏览器、邮件、日历等工具。

这套顺序会慢一点，但更稳。AI 助手一旦接入真实账号，安全边界比功能数量更重要。

7. 常见问题

7.1 命令不存在

确认全局 npm 路径是否在 PATH 中：

npm bin -g

或者重新打开终端。

7.2 Gateway启动失败

常见原因：

• 端口被占用。
• Node 版本太低。
• 配置文件缺失。
• 模型认证信息错误。

先跑：

openclaw doctor

再看 Gateway 日志。

7.3 模型回复慢或不稳定

OpenClaw 是执行型助手，任务上下文通常比普通聊天更复杂。建议使用你信任的当前主力模型，不要用上下文太小、工具调用不稳定的模型做复杂任务。

查看大图

学完《OpenClaw安装与第一次启动》后，不妨换一个自己的场景试一次，重点观察输入、处理和输出是否能对应起来。

查看大图

如果想把《OpenClaw安装与第一次启动》用到自己的任务里，可以先缩小场景，只验证一个最关键的判断点。

8. 本节小结

这一节只追求一个目标：让 OpenClaw 能启动、能调用模型、能回复第一条消息。

下一节我们开始理解它真正的工作系统：通道、模型、记忆、技能和工具。