在 Linux VPS 上部署 OpenClaw：5 分鐘快速設定指南

在 Linux 上部署服務時，最煩人的通常不是寫程式，而是處理環境依賴和背景執行的問題。如果你也曾經為了讓一個服務在伺服器重啟後自動跑起來而抓狂，這篇指南會幫你省下不少時間。

Linux App

Gateway 在 Linux 上得到完整支援。Node 是推薦的 runtime。我們不建議在 Gateway 使用 Bun，因為目前在處理 WhatsApp 和 Telegram 時仍有一些 bug。

目前我們正計劃開發原生的 Linux 桌面端 App。如果你有興趣幫忙一起開發，非常歡迎貢獻程式碼。

新手快速上手 (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

完整的 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 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

---

下一步

• 深入了解 Gateway 運行手冊
• 查看 配置設定 詳情

有任何安裝上的疑難雜症？試試我們的 AI Setup Assistant 幫你快速解決。