跳到內容

使用 openclaw node 建立遠端執行節點

你是不是也遇過這種情況:想在遠端伺服器或家裡的 NAS 執行指令,但又不想在那台機器上裝一堆複雜的 GUI 工具?或者是想把執行環境隔離,但設定起來卻麻煩得要命。

這就是 openclaw node 派上用場的時候。它讓你建立一個 headless node host,透過 WebSocket 連接到 Gateway,並讓機器具備執行 system.run 與 system.which 的能力。

在開始之前,請確保你已經準備好:

  • 一台運作中的 Gateway
  • 想要作為執行節點的機器(Linux、Windows 或其他支援環境)
  • 已安裝 openclaw CLI

要在 5 分鐘內建立並連線你的節點,請按照以下步驟操作:

首先,在你的目標機器上執行以下指令來測試連線:

Terminal window
openclaw node run --host \<gateway-host\> --port 18789

你可以使用的常用參數包括:

  • --host <host>: Gateway 的 WebSocket 位址 (預設:127.0.0.1)
  • --port <port>: Gateway 的 WebSocket 埠號 (預設:18789)
  • --tls: 使用 TLS 連線
  • --display-name <name>: 自定義節點顯示名稱

第一次連線時,Gateway 會收到一個待處理的配對請求。你需要手動核准它:

Terminal window
openclaw nodes pending
openclaw nodes approve \<requestId\>

核准後,節點會將連線資訊儲存在 ~/.openclaw/node.json。

如果你希望節點在開機時自動啟動,可以將它安裝為系統服務:

Terminal window
openclaw node install --host \<gateway-host\> --port 18789

安裝後,你可以用這些指令管理服務:

  • openclaw node status:查看狀態
  • openclaw node stop:停止服務
  • openclaw node restart:重啟服務
  • openclaw node uninstall:移除服務

如果 system.run 無法執行,通常是因為安全性限制。openclaw node 的執行權限是由本地端的核准清單控制的。

  • 檢查設定檔:~/.openclaw/exec-approvals.json
  • 你也可以從 Gateway 遠端編輯:openclaw approvals --node &lt;id|name|ip&gt;

節點預設會自動開啟 Browser Proxy,讓 agent 可以進行瀏覽器自動化。如果你不需要這個功能,可以在設定檔中關閉它:

{
nodeHost: {
browserProxy: {
enabled: false,
},
},
}

如果你在設定過程中遇到任何問題,可以直接詢問 AI Setup Assistant。

OpenClaw

OpenClaw Expert

還是卡住了?

如果這篇文件沒有解決你的情境,直接問 OpenClaw Expert,拿到可執行步驟。