Linux 平台

Gateway 在 Linux 上完全支持，Node 是推荐运行时。Bun 不推荐（WhatsApp/Telegram 问题）。原生 Linux 伴侣应用规划中，欢迎贡献。

快速入门（VPS）

# 1. 安装 Node 24（推荐）或 Node 22 LTS
npm i -g openclaw@latest
 
# 2. 安装并启动 Gateway 服务
openclaw onboard --install-daemon
 
# 3. 从本地机器建立 SSH 隧道
ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
 
# 4. 浏览器访问
# http://127.0.0.1:18789/

Gateway 服务安装

openclaw onboard --install-daemon
# 或
openclaw gateway install
# 或
openclaw configure   # 选择 Gateway service
 
# 修复/迁移
openclaw doctor

systemd 用户服务

OpenClaw 默认安装 systemd 用户服务。共享或常驻服务器可使用系统服务。

创建 ~/.config/systemd/user/openclaw-gateway.service：

[Unit]
Description=OpenClaw Gateway
After=network-online.target
Wants=network-online.target
 
[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
TimeoutStopSec=30
SuccessExitStatus=0 143
KillMode=control-group
 
[Install]
WantedBy=default.target

systemctl --user enable --now openclaw-gateway.service

OOM Kill 防护

Linux 内核在内存不足时会选择 OOM 受害者。OpenClaw 通过将子进程的 oom_score_adj 设为 1000 来优先保护 Gateway：

• 覆盖范围：supervisor 子进程、PTY shell、MCP stdio 服务、浏览器进程
• 验证：cat /proc/<child-pid>/oom_score_adj（期望值 1000）
• 禁用：子进程环境设置 OPENCLAW_CHILD_OOM_SCORE_ADJ=0

如果 VPS 频繁 OOM，增加内存限制或使用 systemd MemoryMax= 控制。

相关链接

• platforms-index — 平台总览
• platform-raspberry-pi — Raspberry Pi 平台