快速路径(VPS)
- 安装 Node 24(推荐)或 Node 22.19+(LTS,仍受支持)。
npm i -g openclaw@latestopenclaw onboard --install-daemon- 从你的笔记本电脑运行:
ssh -N -L 18789:127.0.0.1:18789 <user>@<host> - 打开
http://127.0.0.1:18789/,并使用已配置的共享密钥进行认证 (默认是 token;如果gateway.auth.mode是"password",则使用密码)。
安装
Gateway 服务(systemd)
使用以下任一方式安装:openclaw gateway install 默认会渲染一个 systemd 用户单元。完整的
服务指导,包括用于共享或始终在线主机的系统级单元变体,位于
Gateway 运行手册。
只有在自定义设置时才手动编写单元。最小用户单元示例
(~/.config/systemd/user/openclaw-gateway[-<profile>].service):
内存压力和 OOM 终止
在 Linux 上,当主机、VM 或容器 cgroup 内存耗尽时,内核会选择一个 OOM 牺牲进程。Gateway 网关并不适合作为牺牲进程,因为它拥有长期存在的会话和渠道连接,因此 OpenClaw 会在可能时倾向于先终止瞬态子进程。 对于符合条件的 Linux 子进程启动,OpenClaw 会用一个简短的/bin/sh shim 包装命令,将子进程自身的 oom_score_adj 提高到 1000,然后
exec 真正的命令。这不需要特权:进程始终可以提高自身的 OOM 分数。
覆盖的子进程表面:
- 由 Supervisor 管理的命令子进程
- PTY shell 子进程
- MCP stdio 服务器子进程
- OpenClaw 启动的浏览器/Chrome 进程(通过插件 SDK 进程运行时)
/bin/sh 不可用,或子进程环境将
OPENCLAW_CHILD_OOM_SCORE_ADJ 设置为 0、false、no 或
off 时会跳过。
验证子进程:
1000;Gateway 网关进程本身保持其正常分数(通常为 0)。
systemd 单元的 OOMPolicy=continue 会在 OOM killer 选择瞬态子进程时保持 Gateway 网关服务存活,而不是将整个单元标记为失败并重启所有渠道;失败的子进程/会话会报告自己的错误。
这不能替代正常的内存调优。如果 VPS 或容器反复终止子进程,请提高内存限制、降低并发,或添加更强的资源控制(systemd MemoryMax=、容器内存限制)。