agent-collab（Agent 合作）

Agent Collaboration Framework / 跨部門協作框架

概述

OpenClaw 多 Agent 部署下的協作機制。定義三種工作模式，解決「怎麼讓多個 Agent 協同工作並在一個對話框返回結果」的問題。

三種模式

1. 調度模式（Dispatch）

場景： 一次性任務，不需要來回 方法： sessions_spawn(agentId="<target>", mode="run", task="...") 結果： 自動回到發起者的對話框

用戶 → Main: "幫我查下 LanceDB 狀態"
Main → spawn tech(mode="run"): "檢查 LanceDB 數據庫..."
tech 執行完畢 → 結果自動回到 Main → Main 彙報用戶

適用： 數據查詢、狀態檢查、生成報告、執行腳本

2. 協同模式（Collaborate）

場景： 需要多輪對話，跨部門需要來回討論 方法：

1. sessions_spawn(agentId="<target>", mode="session") → 建立持久 session
2. sessions_send(sessionKey, message) → 發送後續消息
3. 結果自動回到發起者的對話框

用戶 → Main: "分析 VGS 稅務優化"
Main → spawn finance(mode="session"): "分析 VGS 在 Trust 下的稅務影響"
finance → 回初步分析 + 追問
Main → sessions_send: "Trust 結構是 Little Max，Trustee 是 Gui Holdings"
finance → 回完整分析
Main → spawn ecommerce(mode="run"): "老金說走公司省稅，你看現金流夠嗎"
ecommerce → 回現金流建議
Main → 綜合兩邊 → 彙報用戶

適用： 需要追問的分析、跨部門協調、需要上下文的任務

3. 細聊模式（Direct Chat）

場景： 用戶想深入參與討論 方法： 用戶直接到對應部門主管的 Bot 對話框 結果： 在該 Bot 的對話框

用戶直接找 @NaiPo_FinBot: "老金，我想詳細討論一下稅務規劃..."

適用： 深度討論、反覆修改、用戶想全程參與

組織架構定義

高階部門（有獨立 Bot）

低階部門（無獨立 Bot）

原則

• 高階→低階 = 調度（subagents.allowAgents 配置）
• 高階↔高階 = 協同（sessions_spawn + sessions_send）
• 部門主管在自己範圍內自主調度，不需要經過 Main
• 低階可升級為高階（業務量增長後分配獨立 Bot）

HANDOFF 機制（異步推送）

當 session 可能中斷時，用文件推送代替即時通信：

# Main 推任務給 Content
写入 ~/.openclaw/workspace-content/HANDOFF-FROM-MAIN.md

# Content 推結果給 Main
写入 ~/.openclaw/workspace/HANDOFF-FROM-CONTENT.md

HANDOFF 格式

# 來源→目標：任務標題
> 時間，背景說明

## 具體內容
- 任務描述
- 技術資料
- 截止時間

---
*接收方讀取後刪除此文件*

規則

• Push, Not Pull — 主動推送，不等對方來要
• 接收方讀取後刪除文件，表示已接收
• 禁止「等他來問我就給他」

安裝配置

1. openclaw.json — sessions 可見性

{
  "tools": {
    "sessions": {
      "visibility": "all"
    }
  }
}

2. openclaw.json — subagents 配置（調度權限）

{
  "agents": {
    "content": {
      "subagents": {
        "allowAgents": ["designer", "creator", "research", "outline", "writing", "seo"]
      }
    },
    "finance": {
      "subagents": {
        "allowAgents": ["research", "data"]
      }
    }
  }
}

3. 各部門 workspace 目錄

~/.openclaw/workspace/          # Main
~/.openclaw/workspace-content/  # Content
~/.openclaw/workspace-finance/  # Finance
~/.openclaw/workspace-tech/     # Tech
~/.openclaw/workspace-ecommerce/ # Ecommerce

4. 在 Main AGENTS.md 加入三模式規則

參考本 skill 的模式定義，加入 AGENTS.md。