OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Platforms overview

Linux 應用程式

Gateway 在 Linux 上完全受支援。建議使用 節點 作為執行環境；不建議使用 Bun （已知有 WhatsApp/Telegram 問題）。

目前還沒有原生 Linux companion app。歡迎貢獻。

快速路徑（VPS）

  1. 安裝 節點 24（建議）或 節點 22.19+（LTS，仍受支援）。
  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/，並使用已設定的共用 密鑰進行驗證（預設為權杖；若 gateway.auth.mode 為 "password"，則使用密碼）。

完整伺服器指南：Linux 伺服器。逐步 VPS 範例： exe.dev。

安裝

Gateway 服務（systemd）

使用下列其中一種方式安裝：

bash
openclaw onboard --install-daemonopenclaw gateway installopenclaw configure   # select "Gateway service" when prompted

修復或遷移現有安裝：

bash
openclaw doctor

openclaw gateway install 預設會產生 systemd 使用者 unit。完整的 服務指南，包括適用於共用或 常開主機的 系統 層級 unit 變體，位於 Gateway runbook。

只有在自訂設定時才手動撰寫 unit。最小使用者 unit 範例 （~/.config/systemd/user/openclaw-gateway[-<profile>].service）：

ini
[Unit]Description=OpenClaw Gateway (profile: <profile>, v<version>)After=network-online.targetWants=network-online.targetStartLimitBurst=5StartLimitIntervalSec=60 [Service]ExecStart=/usr/local/bin/openclaw gateway --port 18789Restart=alwaysRestartSec=5RestartPreventExitStatus=78TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143OOMPolicy=continueKillMode=control-group [Install]WantedBy=default.target

啟用它：

bash
systemctl --user enable --now openclaw-gateway[-<profile>].service

記憶體壓力與 OOM kill

在 Linux 上，當主機、VM 或容器 cgroup 用盡記憶體時，核心會選擇一個 OOM 犧牲者。Gateway 不適合作為犧牲者，因為它持有長期存在的 工作階段和通道連線，因此 OpenClaw 會在可能時偏向讓暫時性子 程序先被終止。

對於符合條件的 Linux 子程序啟動，OpenClaw 會用一個短的 /bin/sh shim 包裝命令，將子程序自己的 oom_score_adj 提高到 1000，然後 exec 真正的命令。這不需要特權：程序永遠可以提高 自己的 OOM 分數。

涵蓋的子程序介面：

  • Supervisor 管理的命令子程序
  • PTY shell 子程序
  • MCP stdio server 子程序
  • OpenClaw 啟動的 browser/Chrome 程序（透過外掛 SDK 程序執行環境）

此包裝器僅限 Linux，且在 /bin/sh 不可用時，或 子程序 env 將 OPENCLAW_CHILD_OOM_SCORE_ADJ 設為 0、false、no 或 off 時會略過。

驗證子程序：

bash
cat /proc/<child-pid>/oom_score_adj

涵蓋子程序的預期值為 1000；Gateway 程序本身 會保留其正常分數（通常為 0）。

systemd unit 的 OOMPolicy=continue 會在 暫時性子程序被 OOM killer 選中時讓 Gateway 服務保持運作，而不是將整個 unit 標記為失敗並重新啟動所有通道；失敗的子程序/工作階段會回報其 自身錯誤。

這並不能取代一般的記憶體調校。如果 VPS 或容器反覆 終止子程序，請提高記憶體限制、降低並行度，或新增更強的 資源控制（systemd MemoryMax=、容器記憶體限制）。

相關

Was this useful?
On this page

On this page