Linux 應用程式

閘道在 Linux 上受到完整支援，且需要節點。Bun 仍可用作相依套件安裝程式或套件指令碼執行器，但無法執行 OpenClaw，因為它不提供 node:sqlite。

桌面輔助程式

OpenClaw Linux 輔助程式是供本機閘道使用的 Tauri 桌面應用程式。它會：

• 在缺少 OpenClaw 命令列介面和受管理的節點執行階段時進行安裝
• 在嘗試變更服務前連接至運作正常的閘道
• 將安裝、啟動、停止和重新啟動作業委派給命令列介面管理的 systemd 使用者服務
• 使用解析出的驗證 URL 開啟由閘道提供的控制介面
• 視窗關閉後仍可從系統匣使用

從 main 建置的穩定版本會在該標記的 GitHub 發行版本中，將 .deb 和 AppImage 套件組合作為資產發布，名稱為 OpenClaw-<version>-amd64.deb 和 OpenClaw-<version>-amd64.AppImage，旁邊並附有 SHA256SUMS.linux-app.txt 總和檢查碼檔案。下載 .deb 並使用 sudo apt install ./OpenClaw-<version>-amd64.deb 安裝，或將 AppImage 標記為可執行並直接執行。AppImage 執行階段需要 FUSE 2（sudo apt install libfuse2，Ubuntu 24.04+ 則為 libfuse2t64）；若沒有，請使用 APPIMAGE_EXTRACT_AND_RUN=1 執行 AppImage。

你也可以從原始碼簽出建置相同的套件組合：

cd apps/linux/src-tauripnpm dlx @tauri-apps/cli@2.11.4 build --bundles deb,appimage

Linux App CI 工作流程會針對涉及此應用程式的提取要求和手動執行，將相同的套件組合上傳為 openclaw-linux-companion 成品。Linux 建置相依套件和開發命令請參閱儲存庫中的 apps/linux/README.md。

命令列介面與 SSH 替代方案

對於無頭伺服器、VPS 或遠端閘道，命令列介面仍是最簡單的選項：

1. 安裝節點 24.15+（建議）、節點 22.22.3+（LTS）或節點 25.9+。
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。

節點功能

隨附的 Linux 節點外掛讓命令列介面無須桌面應用程式即可取得 openclaw node 服務裝置功能。只有在功能已啟用且所需的本機工具存在時，命令才會公告給閘道。

在 openclaw.json 中設定外掛：

{  plugins: {    entries: {      "linux-node": {        config: {          notify: { enabled: true },          camera: { enabled: true },          location: { enabled: true },        },      },    },  },}

變更這些設定後，請重新啟動節點服務。可用性會在每個程序中判定一次，並在重新啟動時重建節點公告。

閘道會將節點的命令與功能介面和裝置配對分開核准。第一次啟動或啟用更多功能後，請核准待處理的介面：

openclaw nodes pendingopenclaw nodes approve <requestId>

節點可以保持連線且已完成裝置配對，但其有效的 caps 和 commands 在此核准完成前仍可能為空。

相機裝置必須可由服務使用者讀取，通常透過 video 群組取得權限。當 includeAudio 為 true 時，相機短片會使用預設的 PulseAudio 或 PipeWire 來源；麥克風音訊只會作為該短片的音軌存在，不會成為獨立命令。位置功能要求節點服務使用者獲得主機 GeoClue 原則的許可。

camera.snap 和 camera.clip 也需要透過 gateway.nodes.allowCommands 由閘道明確啟用。承載內容、限制和錯誤請參閱相機擷取和位置命令。

安裝

• 開始使用
• 安裝與更新
• 選用：Bun 套件工作流程、Nix、Docker

閘道服務（systemd）

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

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

修復或遷移現有安裝：

openclaw doctor

openclaw gateway install 預設會產生 systemd 使用者單元。完整的服務指南（包括適用於共用或持續運作主機的系統層級單元變體）請參閱閘道操作手冊。

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

[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

啟用它：

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

記憶體壓力與 OOM 終止

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

對於符合條件的 Linux 子程序生成，OpenClaw 會在命令外包覆一個簡短的 /bin/sh 墊片，將子程序本身的 oom_score_adj 提高至 1000，然後對實際命令執行 exec。這不需要特殊權限：程序永遠可以提高自己的 OOM 分數。

涵蓋的子程序介面：

• 由監督程式管理的命令子程序
• PTY shell 子程序
• MCP stdio 伺服器子程序
• 由 OpenClaw 啟動的瀏覽器/Chrome 程序（透過外掛 SDK 程序執行階段）

此包裝程式僅適用於 Linux；若 /bin/sh 無法使用，或子程序環境將 OPENCLAW_CHILD_OOM_SCORE_ADJ 設為 0、false、no 或 off，則會略過。

驗證子程序：

cat /proc/<child-pid>/oom_score_adj

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

systemd 單元的 OOMPolicy=continue 會在 OOM 終止程式選中暫時性子程序時，讓閘道服務保持運作，而不是將整個單元標記為失敗並重新啟動所有頻道；失敗的子程序/工作階段會回報自己的錯誤。

這無法取代正常的記憶體調校。若 VPS 或容器反覆終止子程序，請提高記憶體限制、降低並行程度，或加入更強的資源控制（systemd MemoryMax=、容器記憶體限制）。

相關內容

• 安裝概觀
• Linux 伺服器
• Raspberry Pi
• 閘道操作手冊
• 閘道設定