02. 快速开始：安装、onboard、启动 Gateway

这篇解决什么问题

这一篇只做一件事：让 OpenClaw 先跑起来。

先不讲源码。源码解读最好建立在真实运行体验上。否则你很难理解为什么项目里会有 Gateway、Channels、Sessions、Daemon、Nodes 这些目录。

前置条件

官方 README 写得很明确：

Node 24 recommended
or Node 22.19+

先确认 Node 版本：

node -v

如果低于 Node 22.19，先升级。OpenClaw 的 launcher 里也有版本检查，低版本会直接退出。

安装

官方推荐：

npm install -g openclaw@latest

也可以用：

pnpm add -g openclaw@latest

安装完成后：

openclaw --version

推荐启动方式：onboard

官方推荐新用户走：

openclaw onboard --install-daemon

onboard 会引导你设置 Gateway、workspace、channels、skills 等。--install-daemon 会把 Gateway 安装成常驻服务，例如 macOS launchd 或 Linux systemd user service。

这很重要：OpenClaw 的常态不是每次手动启动一个脚本，而是 Gateway 长期运行。

查看 Gateway 状态

openclaw gateway status

如果状态不正常，先不要继续配 channel。先把 Gateway 跑起来。

前台调试模式

openclaw gateway stop
openclaw gateway --port 18789 --verbose

前台模式适合开发和排障，不适合长期运行。

发起一次 Agent 消息

openclaw agent --message "Hello" --thinking low

如果你已经连接了 Telegram、Feishu、Slack 等渠道，也可以通过平台发消息。

状态目录在哪里

OpenClaw 默认状态目录是：

~/.openclaw

如果设置了：

OPENCLAW_STATE_DIR=/path/to/state

则使用自定义状态目录。

常见卡点

Node 版本不够

表现：命令直接报 Node 版本要求。

处理：升级到 Node 24 或至少 Node 22.19+。

Gateway 没启动

表现：channel 能配置，但消息没有响应。

处理：先看：

openclaw gateway status

必要时前台跑：

openclaw gateway --port 18789 --verbose

远程 DM 没响应

OpenClaw 默认把 inbound DM 当成不可信输入。很多平台默认走 pairing / allowlist。陌生人直接 DM 不会被处理。

看安全章节前，不要随便把 DM policy 改成 open。

实践：动手检查

完成 onboard 后，不要急着接第二个渠道。先在本机完成一个最小闭环：

openclaw --version
openclaw gateway status
openclaw agent --message "只回复：OpenClaw 已连通" --thinking low

然后查看 ~/.openclaw，确认状态目录已经产生实际内容。不要删除或编辑其中的凭证文件。

完成标准

• Node 版本满足要求；
• openclaw --version 能正常输出；
• Gateway 状态正常；
• Agent 消息能返回指定文本；
• 能找到当前使用的状态目录；
• Gateway 重启后再次发送消息仍能成功。

多走一步

用一个已接入的 Channel 再发送同样的消息，比较 CLI 和远程渠道的响应。此时只验证链路，不要把 DM policy 改成 open。

下一篇看什么

下一篇看配置和模型。