Linux

Linux 应用

Gateway 在 Linux 上完全支持。Node 是推荐的运行时。
不推荐 Bun 作为 Gateway（WhatsApp/Telegram 有 bug）。

计划推出原生 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/ 并粘贴你的令牌

分步 VPS 指南：[exe.dev(../platforms/exe-dev.html)

安装

• 入门
• [安装和更新(../install/updating.html)
• 可选流程：[Bun（实验性）(../install/bun.html)、[Nix(../install/nix.html)、[Docker(../install/docker.html)

Gateway

• Gateway 运行手册
• [Gateway 配置(../gateway/configuration.html)

Gateway 服务安装（CLI）

使用以下之一：

openclaw onboard --install-daemon

或：

openclaw gateway install

或：

openclaw configure

在提示时选择 Gateway 服务。

修复/迁移：

openclaw doctor

系统控制（systemd 用户单元）

OpenClaw 默认安装 systemd 用户 服务。对共享或始终在线的服务器使用 系统 服务。完整单元示例和指导在 Gateway 运行手册 中。

最小设置：

创建 ~/.config/systemd/user/openclaw-gateway[-<profile>].service：

[Unit]
Description=OpenClaw Gateway（配置文件：<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