Linux 應用程式

Gateway 在 Linux 上完整支援。建議使用 Node 作為執行環境。 不建議以 Bun 執行 Gateway（WhatsApp/Telegram 會出現 bug）。

原生 Linux 配套應用程式仍在規劃中。歡迎有興趣的開發者貢獻。

新手快速路徑（VPS）

1. 安裝 Node 24（建議；Node 22 LTS（目前為 22.16+）仍可相容使用）
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 user 服務。若用於共享或常駐伺服器，建議改用 system 服務。完整的 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