🌐

AI Agent 自主代理三王實戰

CH19 | 多台電腦,一起聽話

讓多台機器上的龍蝦組成一個網路,互相合作——家裡桌機、辦公室筆電、雲端伺服器,統統串在一起

📋 本章學習目標

  • 認識 Nodes 多機架構的概念
  • 了解主控節點與工作節點的角色
  • 學會設定多台龍蝦分工合作
  • 認識實際的應用場景
1 / 10

19.1 Nodes 多機架構介紹

你的龍蝦現在只住在「一台電腦」上。但如果你有好幾台電腦呢?Nodes 功能讓你把多個節點串在一起,形成一個「龍蝦網路」

Nodes 架構圖

為什麼需要多節點?

情境單機的限制多節點的解法
電腦關機就斷線龍蝦下線,無法接收訊息雲端節點 24hr 接收,本機負責重工作
多台電腦要管理每台各自裝龍蝦,互不相干多節點串聯,統一管理
運算效能不夠小筆電跑 AI 很慢把 AI 運算丟給效能好的節點
多人協作每人各自操作龍蝦之間可以互相傳遞任務
2 / 10

節點的角色:Primary vs Worker

👔 Primary(主控節點)

比喻:公司的總經理

  • 接收所有通道的訊息(LINE、Telegram 等)
  • 判斷任務要交給誰
  • 彙整結果回覆使用者
  • 維持節點清單
通常放在雲端伺服器或 24 小時開機的電腦上

🔧 Worker(工作節點)

比喻:各部門的員工

  • 向主控註冊「我上線了」
  • 接收主控分派的任務
  • 執行任務(跑 AI、操作檔案等)
  • 完成後回報結果
可以是家用電腦、辦公室筆電、或另一台雲端伺服器
        ┌─────────────┐
        │   LINE 訊息   │
        └──────┬──────┘
               │
        ┌──────▼──────┐
        │   Primary    │  ← 主控節點(雲端伺服器)
        │  接收訊息     │     24 小時在線
        │  分派任務     │
        └──┬───────┬──┘
           │       │
    ┌──────▼──┐ ┌──▼──────┐
    │ Worker A │ │ Worker B │
    │ 家裡桌機  │ │ 辦公室筆電│
    │ 跑 AI 運算│ │ 操作檔案  │
    └─────────┘ └─────────┘
3 / 10

節點能力標籤(NODE.md)

每個工作節點可以宣告自己的「能力」,讓主控知道該把什麼任務分派給它:

# NODE.md(工作節點的設定檔)

## 節點名稱
家裡桌機

## 能力
- desktop-agent(可操控瀏覽器和檔案)
- gpu-compute(有好顯卡,可跑本地 AI)
- file-access(可存取家裡的 NAS)

## 在線時段
- 平日:18:00-23:00
- 假日:全天

主控節點的分派邏輯

🖥️ 操控桌面

分給「家裡桌機」(有 desktop-agent 能力)

🧠 跑本地 AI

分給「家裡桌機」(有 GPU)

🌙 凌晨任務

不分給「家裡桌機」(可能關機了),改由雲端處理

💡 一個 Nodes 網路裡只有一個 Primary,但可以有多個 Worker(最多 5 個)。
4 / 10

19.3 設定多台龍蝦分工合作

步驟一:設定主控節點

# 啟用 Nodes 功能
openclaw config set nodes.enabled true

# 設定自己為 Primary
openclaw config set nodes.role primary

# 產生節點金鑰(讓其他節點能安全連線)
openclaw nodes init
🔑 Nodes 初始化完成!
   節點 ID:node-abc123
   連線金鑰:sk-nodes-xxxxxxxxxxxxxxxx

   ⚠️ 請把連線金鑰複製給你的工作節點。
   這個金鑰只顯示一次,請妥善保管。

步驟二:設定工作節點

# 啟用 Nodes 功能
openclaw config set nodes.enabled true

# 設定自己為 Worker
openclaw config set nodes.role worker

# 連線到主控節點
openclaw nodes join --primary https://你的主控域名:18789 --key sk-nodes-xxxxxxxxxxxxxxxx
✅ 已成功連線到主控節點!
   主控:https://lobster.你的域名.com:18789
   我的節點 ID:node-def456
   我的角色:Worker
   延遲:32ms
5 / 10

測試連線與任務分派

步驟四:確認工作節點上線

Nodes 列表
openclaw nodes list

🌐 Nodes 網路狀態:

  [Primary] node-abc123 — 雲端伺服器
    狀態:✅ 在線
    IP:xxx.xxx.xxx.xxx
    運行時間:3 天 2 小時

  [Worker] node-def456 — 辦公室筆電
    狀態:✅ 在線
    延遲:32ms
    能力:file-access, browser, office-tools
    在線時段:平日 09:00-18:00

步驟五:測試分派任務

你(LINE):幫我看看辦公室電腦桌面上有什麼檔案
龍蝦:📡 分派任務到「辦公室筆電」...
      📁 辦公室筆電桌面上的檔案:
      - 會議簡報.pptx
      - 本月報表.xlsx
      - 專案進度.docx
      共 3 個檔案。
6 / 10

19.4 實戰範例

跨節點任務

範例一:家庭 + 雲端雙節點

節點角色位置負責什麼
GitHub CodespacesPrimary雲端接收 LINE 訊息、基本對話
家裡桌機Worker家裡AI 運算、瀏覽器操控、檔案管理
場景:你在外面用手機

你(LINE):今天天氣如何?
龍蝦:☀️ 台北 28°C,晴天。(由雲端節點回答)

你(LINE):幫我看看家裡電腦桌面上那份報告的內容
龍蝦:📡 分派到「家裡桌機」...
      📄 report.docx 摘要:
      ...(內容摘要)
💡 簡單的聊天由雲端節點處理(24 小時在線),需要操控桌面的任務則分派給家裡桌機。
7 / 10

更多實戰範例

範例二:辦公室 + 家裡雙向管理

你(LINE):辦公室電腦上的專案進度更新到哪了?
龍蝦:📡 詢問「辦公室筆電」...
      📋 專案進度(截至今天 15:00):
      - 前端開發:75%  |  後端 API:90%  |  測試:40%

你(LINE):把那份進度報表也複製到家裡電腦的桌面
龍蝦:📡 從「辦公室筆電」下載...
      📡 上傳到「家裡桌機」...
      ✅ 已複製到家裡桌機的桌面。

範例三:多人共用龍蝦網路

場景:你是專案經理,朋友 A 是設計師,朋友 B 是工程師

你(LINE):幫我問 A 的龍蝦,設計稿完成了嗎?
龍蝦:📡 詢問「A 的工作站」...
      🎨 A 的龍蝦回報:首頁設計稿已完成,共 5 個頁面。

你(LINE):好,把設計稿轉給 B 的龍蝦,請它開始切版
龍蝦:📡 轉派任務到「B 的工作站」...
      💻 B 的龍蝦回報:收到設計稿,開始切版。
      預計完成時間:明天下午。
⚡ 「龍蝦對龍蝦」的協作目前還在早期階段,但概念本身非常有潛力——想像未來每個人的 AI 助手之間可以互相溝通協作!
8 / 10

19.5 注意事項與常見問題

網路與安全

項目說明
連線加密節點之間的通訊使用 TLS 加密,不用擔心被竊聽
金鑰管理連線金鑰只在 nodes join 時使用一次,之後用節點 ID 認證
防火牆工作節點不需要開放 Port,它是主動連出去的
斷線重連工作節點斷線後會自動嘗試重連(間隔 30 秒)

目前的限制

📊 最多 5 個 Worker

一個 Nodes 網路最多支援 5 個工作節點

📦 檔案大小限制

跨節點的檔案傳輸預設上限 100MB

↩️ 回覆路徑

工作節點不能直接回覆使用者,必須透過主控節點

🔄 分派邏輯

任務分派邏輯還比較基礎,不像企業級任務佇列

💡 Nodes vs CH14 多重分身:多重分身是「一台電腦上跑多個 Gateway」(多個獨立龍蝦);Nodes 是「多台電腦上的龍蝦串在一起」(一個龍蝦網路)。兩者可搭配使用。
9 / 10

19.7 小結與展望

🌐 Nodes 架構

Primary 主控節點 + 多個 Worker 工作節點,形成「龍蝦網路」。

⚙️ 節點設定

openclaw nodes init 初始化主控 + openclaw nodes join 加入工作節點。

📋 能力宣告

NODE.md 定義每個節點的能力和在線時段,主控按能力分派任務。

🏠 實戰範例

家庭+雲端、辦公室+家裡、多人協作——讓龍蝦不再只住在一台電腦裡。

📖 下一章預告:CH20 讓龍蝦打電話給你
龍蝦跟你的互動一直都是文字。有沒有可能用「說的」?不是語音辨識轉文字,而是真的打電話跟龍蝦聊天

前往 CH20 ➡️
10 / 10