跳转到主要内容
Gateway 网关在 Linux 上完全受支持。Node 是推荐的运行时;不推荐 Bun(存在已知 WhatsApp/Telegram 问题)。 目前还没有 Linux 原生配套应用。欢迎贡献。

快速路径(VPS)

  1. 安装 Node 24(推荐)或 Node 22.19+(LTS,仍受支持)。
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. 从你的笔记本电脑运行:ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. 打开 http://127.0.0.1:18789/,并使用已配置的共享密钥进行认证 (默认是 token;如果 gateway.auth.mode"password",则使用密码)。
完整服务器指南:Linux 服务器。分步 VPS 示例: exe.dev

安装

Gateway 服务(systemd)

使用以下任一方式安装:
openclaw onboard --install-daemon
openclaw gateway install
openclaw configure   # select "Gateway service" when prompted
修复或迁移现有安装:
openclaw doctor
openclaw gateway install 默认会渲染一个 systemd 用户单元。完整的 服务指导,包括用于共享或始终在线主机的系统级单元变体,位于 Gateway 运行手册 只有在自定义设置时才手动编写单元。最小用户单元示例 (~/.config/systemd/user/openclaw-gateway[-<profile>].service):
[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target
StartLimitBurst=5
StartLimitIntervalSec=60

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
RestartPreventExitStatus=78
TimeoutStopSec=30
TimeoutStartSec=30
SuccessExitStatus=0 143
OOMPolicy=continue
KillMode=control-group

[Install]
WantedBy=default.target
启用它:
systemctl --user enable --now 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 进程运行时)
该包装器仅适用于 Linux;当 /bin/sh 不可用,或子进程环境将 OPENCLAW_CHILD_OOM_SCORE_ADJ 设置为 0falsenooff 时会跳过。 验证子进程:
cat /proc/<child-pid>/oom_score_adj
覆盖的子进程的预期值为 1000;Gateway 网关进程本身保持其正常分数(通常为 0)。 systemd 单元的 OOMPolicy=continue 会在 OOM killer 选择瞬态子进程时保持 Gateway 网关服务存活,而不是将整个单元标记为失败并重启所有渠道;失败的子进程/会话会报告自己的错误。 这不能替代正常的内存调优。如果 VPS 或容器反复终止子进程,请提高内存限制、降低并发,或添加更强的资源控制(systemd MemoryMax=、容器内存限制)。

相关