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

Platforms overview

Linux 應用程式

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

桌面輔助應用程式

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

  • 在缺少 OpenClaw 命令列介面與受管理的節點執行階段時加以安裝；發行組建會自動安裝穩定通道，而開發組建會先詢問要使用的通道
  • 在嘗試變更服務前，先連線至運作正常的閘道
  • 將安裝、啟動、停止及重新啟動作業委派給由命令列介面管理的 systemd 使用者服務
  • 探索附近的 Bonjour 閘道，並在按路由限定範圍的視窗中開啟各自的控制介面，讓多個 閘道儀表板可保持連線並同時使用
  • 使用解析後的驗證 URL 開啟由閘道提供的控制介面
  • 在首次執行安裝後，以新手引導模式開啟控制介面，讓你選擇將偵測到的 Claude Code、Codex 或 Hermes 記憶匯入 代理程式工作區（之後仍可從 Settings → Import Memory 使用相同的匯入功能）
  • 為位於同一處的命令列介面節點主機呈現由代理程式驅動的 Canvas 與隨附的 A2UI 內容
  • 視窗關閉後仍可從系統匣使用

從 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。

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

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

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

快速聊天

使用 Ctrl+Shift+Space 或系統匣中的 快速聊天 項目開啟快速聊天。代理程式 方塊會顯示已設定的頭像、表情符號或姓名縮寫；選取它即可切換代理程式。 訊息會使用所選代理程式的主要工作階段，並遵循全域工作階段範圍。 原生 Rust 用戶端擁有持久的 Ed25519 裝置身分。它僅使用 命令列介面交接提供的共用權杖或密碼來引導配對，之後的連線則儲存並優先使用 閘道核發的裝置權杖。身分與 裝置權杖存放在應用程式設定目錄中模式為 0600 的檔案內；快速 聊天的 WebView 不會收到任何認證資訊或 WebSocket。

原生連線無法使用時，快速聊天會顯示 無法連線至閘道 — 正在重試，並停用傳送功能，直到重新連線。已進入配對階段的遠端裝置 則會顯示 請在儀表板中核准此裝置 （節點）；若閘道有提供，也會顯示簡短的裝置 ID。 需要但缺少共用認證資訊的閘道會顯示 閘道需要 認證資訊 — 請在閘道主機上開啟儀表板；在此狀態下，沒有等待核准的配對要求。當伺服器提供的修復指引 更具體時，會取代這些備援通知。 對於 TLS 閘道，命令列介面會將閘道憑證的 SHA-256 指紋交給應用程式；原生用戶端會釘選該憑證，並將 閘道 TLS 信任失敗 — 請檢查憑證指紋 與停機狀態分開回報。 透過 SecretRef 設定共用密鑰的閘道不會在 命令列介面交接中包含該密鑰。現有的已配對安裝仍可透過已儲存的裝置 權杖繼續運作，但全新安裝若缺少該引導認證資訊，在共用密鑰 驗證下便無法建立待處理的配對要求。 設定代碼與 bootstrapToken 兌換需要專用的產品介面，仍是 後續工作；快速聊天不會嘗試執行任一流程。

在 X11 上，使用快速聊天中的齒輪來錄製或重設自訂快速鍵。 快速聊天快速鍵 系統匣切換項目可啟用或停用快速鍵，而不會停用一般的 快速聊天 系統匣項目。Wayland 不支援全域快速鍵，因此 快速鍵設定會隱藏，系統匣項目仍是進入點。 成功送出訊息後，快速聊天會保持開啟，並在撰寫區下方串流顯示所選代理程式的 純文字回覆。按下 Esc 可關閉聊天列及其回覆； Ctrl+Enter 仍會開啟儀表板。

Canvas

Linux Canvas 使用兩個相互協作的程序。openclaw node run 仍是唯一的閘道節點連線；隨附的 linux-canvas 外掛會透過僅限使用者存取的 Unix 通訊端，將 canvas.* 呼叫轉送至執行中的桌面應用程式。應用程式擁有一個按需開啟的 WebView 視窗，其中包含隨附的 A2UI 轉譯器及返回代理程式的動作橋接。

此外掛預設為啟用。只有當桌面通訊端位於 $XDG_RUNTIME_DIR/openclaw-canvas.sock，或在 XDG_RUNTIME_DIR 無法使用時位於 /tmp/openclaw-canvas-$UID.sock，它才會宣告 Canvas。使用 plugins.entries.linux-canvas.enabled: false 停用。在沒有桌面應用程式的無頭 Linux 伺服器上，不會宣告 Canvas。

Linux v1 使用一個 Canvas 視窗。HTTP 與 HTTPS 頁面皆可轉譯，但只有隨附的轉譯器所發出的 A2UI 動作會被接受。

命令列介面與 SSH 替代方案

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

  1. 安裝 Node 24.15+（建議）、Node 22.22.3+（LTS）或 Node 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 服務裝置功能，而不需要桌面應用程式。只有在功能已啟用且所需的本機工具存在時，才會向閘道宣告指令。

功能 預設值 需求
桌面通知（system.notify） 開啟 libnotify 的 notify-send 與桌面通知工作階段
相機相片與短片（camera.*） 關閉 FFmpeg、V4L2 相機存取權，以及用於短片音訊的 PulseAudio 或 PipeWire
位置（location.get） 關閉 GeoClue2 及其 where-am-i 示範程式

在 openclaw.json 中設定外掛：

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

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

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

bash
openclaw nodes pendingopenclaw nodes approve <requestId>

節點可以保持連線並完成裝置配對，但其有效的 caps 與 commands 仍會維持空白，直到完成此核准。

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

camera.snap 與 camera.clip 還需要透過 gateway.nodes.commands.allow 在閘道中明確啟用。有效負載、限制及錯誤請參閱相機擷取與位置指令。

安裝

閘道服務（systemd）

使用下列任一方式安裝：

bash
openclaw onboard --install-daemonopenclaw gateway installopenclaw configure   # 出現提示時選取 "Gateway service"

修復或遷移現有安裝：

bash
openclaw doctor

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

只有在自訂設定時才應手動撰寫單元。最小使用者單元範例 （~/.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

手動撰寫的單元不會繼承 openclaw gateway install 為受管理閘道服務寫入的自適應堆積大小調整。建議使用受管理的安裝程式；若使用自訂監督程式，請在考量原生記憶體預留空間後設定明確的堆積限制。

啟用服務：

bash
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 時，會略過此程序。

驗證子程序：

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

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

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

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

相關內容

Was this useful?
On this page

On this page