Linux 應用程式

在 Linux 系統上執行 OpenClaw Gateway 的說明文件，Node.js 為推薦的執行環境。

Gateway 在 Linux 上完整支援。Node 是推薦的執行環境。 不建議將 Bun 用於 Gateway（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

安裝

• 入門指南
• 安裝與更新
• 選用流程：Bun（實驗性）、Nix、Docker

Gateway

• Gateway 操作手冊
• 設定

Gateway 服務安裝（CLI）

使用以下任一方式：

openclaw onboard --install-daemon

或：

openclaw gateway install

或：

openclaw configure

出現提示時選擇 Gateway service。

修復/遷移：

openclaw doctor

系統控制（systemd user unit）

OpenClaw 預設安裝 systemd 使用者服務。對於共用或常駐伺服器，請使用系統服務。完整的 unit 範例與指引請參閱 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