Linux 应用

Gateway 在 Linux 上完全支持。推荐使用 Node 作为 Runtime。 不推荐在 Gateway 上使用 Bun（存在 WhatsApp/Telegram 相关问题）。

原生 Linux 配套应用正在计划中。如果你想帮忙开发,欢迎贡献代码。

新手快速上手（VPS）

  1. 安装 Node 22+
  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 详细教程: exe.dev

安装

Gateway

Gateway 服务安装（CLI）

使用以下任一命令:

openclaw onboard --install-daemon

或:

openclaw gateway install

或:

openclaw configure

提示时选择 Gateway service。

修复/迁移:

openclaw doctor

系统控制（systemd 用户单元）

OpenClaw 默认安装 systemd user 服务。如果是共享服务器或需要持续运行,使用 system 服务。完整的单元示例和指南请查看 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