安装 OpenClaw 网关(2026)

OpenClaw 是开源、可自托管的多渠道 AI agent 网关(Node.js/TypeScript,MIT)。和 Hermes(Python,得手写 systemd unit)不同,OpenClaw 自己管自己的网关服务——一条命令就装好 systemd unit。本指南对照一台跑着 OpenClaw 网关的活实例核验过。

1. 安装(npm 全局)

OpenClaw 是个 npm 包。先有 Node.js 20+:

1
npm install -g openclaw

确认:

1
openclaw --version

二进制落在 npm 全局 bin(比如 ~/.local/bin/openclaw)。确保它在 PATH 上。

2. 配置

交互式配置——凭据、渠道、网关、agent 默认:

1
openclaw configure

或者用交互式安装+修复助手:

1
openclaw crestodian

配置在 ~/.openclaw/openclaw.json,密钥在 ~/.openclaw/.env。非交互校验:

1
openclaw config validate

3. 把网关装成服务并启动

OpenClaw 自己装自己的 systemd user 服务(macOS 是 launchd,Windows 是 schtasks)——unit 不用你手写:

1
2
3
openclaw gateway install    # 装 systemd user 服务
openclaw gateway start      # 启动
openclaw gateway status     # 看跑没跑

在 Linux/WSL2 上这会在 ~/.config/systemd/user/ 下建 openclaw-gateway.service。要让它开机自启 + 没活动登录会话也跑,开 linger:

1
loginctl enable-linger $USER

想前台跑(不要服务),用 openclaw gateway run。

4. 加渠道

加 + 登录消息渠道:

1
openclaw channels           # 列出/加/登录/查看渠道

然后在配好的渠道上发条消息——网关把它路由给 agent。

一个真实的版本滞后坑(2026-07-31 核验)

在核验本指南的那台实例上,npm ls -g 报的是 [email protected],但 config 是 2026.7.1-2 写的。OpenClaw 自己每次跑 CLI 都会报警:

你的 OpenClaw config 由 2026.7.1-2 写,但当前命令跑的是 2026.6.8。更新 PATH 让 openclaw 指向你要的版本,或从那个同样的 OpenClaw 安装重装 Gateway 服务。

意思是:npm 全局二进制和config/state 的版本会脱节——比如你 npm i -g openclaw(拿到发布包)时,一个更新的 dev 或 git build 已经写了你的 config。对齐方法:把 openclaw 指向你要的版本(更新 PATH / 你的 node 版本管理器),然后 openclaw gateway uninstall && openclaw gateway install 从那个同样的安装重装服务。跑 openclaw gateway status --deep 确认服务 + 版本一致。

知道这个很有用——别误以为网关"忘了"你的 config,通常没忘,只是 CLI 滞后了。

来源 + 时效

命令来自 OpenClaw 官方文档(网关 CLI、openclaw/openclaw)。npm 全局安装路径、openclaw gateway install 服务安装流程、版本滞后坑于 2026-07-31 对照活实例核验(OpenClaw 2026.7.1-2)。OpenClaw 迭代快——部署前重新核对包版本 + 文档。