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。

下一篇看什么

下一篇看配置和模型。