Linux 应用

Gateway 在 Linux 上完整支持。Node 是推荐运行时。 Bun 不推荐用于 Gateway（有 WhatsApp/Telegram 兼容性问题）。

原生 Linux 伴侣应用正在规划中。如果你想参与开发，欢迎贡献代码。

新手快速路径（VPS）

1. 安装 Node 24（推荐；Node 22 LTS，当前 22.14+，仍可兼容）
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

四步下来，你的龙虾就在 VPS 上跑起来了，本地浏览器通过 SSH 隧道直连控制台。

完整 Linux 服务器指南：Linux Server。分步 VPS 示例：exe.dev

安装

• 快速开始
• 安装与更新
• 可选方式：Bun（实验性）、Nix、Docker

Gateway

• Gateway 运维手册
• 配置参考

Gateway 服务安装（CLI）

使用以下任一方式：

openclaw onboard --install-daemon

或：

openclaw gateway install

或：

openclaw configure

在提示时选择 Gateway service。

修复/迁移：

openclaw doctor

系统控制（systemd 用户单元）

OpenClaw 默认安装 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

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

启用：

systemctl --user enable --now openclaw-gateway[-<profile>].service