Files
KingClawArmy/docs/spec_v4_collaboration_scheduling_memory.md
Chris 8d97610634 Initial commit: KingClawArmy AI Agent Team spec v4
Pure OpenClaw architecture for 15-17 agent team covering quant research,
marketing, content, and engineering. Includes org structure, role definitions,
collaboration patterns, scheduling, memory architecture, Discord integration,
rollout plan, and JSON schemas.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-09 03:39:29 +08:00

7.9 KiB
Raw Blame History

KingClawArmy - 第四部分:協作模式 & 第五部分:排程與觸發 & 第六部分:記憶 & 第七部分Discord


第四部分:協作模式

4.1 三種模式(全部在 OpenClaw 內完成)

模式 OpenClaw 實現 場景
Orchestrator CEO 用 sessions_spawn 派工給 sub-agent 日常任務分派
Peer-to-Peer Agent 之間用 sessions_send 來回溝通(最多 5 輪) 追問、澄清、交叉驗證
Coordinator 討論 CEO 用 sessions_send 逐一收集觀點再收斂 多方意見整合、辯論替代

4.2 協作模式詳細流程

Orchestrator派工

CEO 收到任務
  ↓
sessions_spawn("finance_researcher", task="蒐集今日盤前資訊")
  ↓
財經情報研究員在獨立 session 中執行
  ↓
完成後 push 結果回 CEO
  ↓
CEO 收到結果spawn 下一個 agent

Peer-to-Peer直接溝通

量化策略研究員讀完多方報告後有疑問
  ↓
sessions_send("bullish_researcher", "你提到 OB 支撐,具體是哪個價位?")
  ↓
多方研究員回覆ping-pong 最多 5 輪)
  ↓
量化策略研究員獲得澄清,繼續工作

Coordinator 討論(辯論替代方案)

CEO 需要整合多空觀點
  ↓
step 1: sessions_send("bullish_researcher", "總結你的核心做多論點")
step 2: sessions_send("bearish_researcher", "總結你的核心做空論點")
step 3: sessions_send("bearish_researcher", "針對多方的論點 [X],你的反駁是?")
step 4: sessions_send("bullish_researcher", "針對空方的反駁 [Y],你的回應是?")
step 5: sessions_send("quant_strategist", "以下是雙方觀點 [全文],請收斂成策略")
  ↓
CEO 收到策略規格

4.3 什麼場景用什麼模式

場景 模式 理由
蒐集資料 Orchestrator spawn 獨立任務,不需互動
寫回測程式 Orchestrator spawn 獨立任務
多空辯論 Coordinator 討論 需要多方觀點交叉
追問細節 Peer-to-Peer send 兩個 agent 直接對話
審查來回 Peer-to-Peer send 審查員與被審者 ping-pong
跨團隊對齊 Coordinator 討論 CEO 逐一收集再收斂
你下達指令 Discord → CEO 你對 CEO 說話
需要你批准 CEO → Discord @你 HITL

4.4 Review Gate

必審節點 觸發方式
量化策略提交 CEO spawn 審查員 review
回測結果提交 CEO spawn 審查員 review
工程交付 CEO spawn 審查員 review
文案對外 CEO spawn 審查員 review

4.5 HITL 節點

需要你批准的事 通知方式
正式部署 Discord #approvals @你
DB schema 變更 Discord #approvals @你
廣告正式發布 Discord #approvals @你
對外訊息發送 Discord #approvals @你
金流操作 Discord #approvals @你
量化策略正式執行 Discord #approvals @你

第五部分:排程與觸發

5.1 Cron 排程

# 財經情報 — 每日盤前盤後
openclaw cron add --agent finance_researcher --cron "30 7 * * 1-5" --task "盤前資訊蒐集"
openclaw cron add --agent finance_researcher --cron "30 18 * * 1-5" --task "盤後資訊整理"

# 市場研究 — 每日 + 每週
openclaw cron add --agent market_researcher --cron "0 10 * * *" --task "每日市場情報"
openclaw cron add --agent market_researcher --cron "0 9 * * 1" --task "每週市場分析報告"

# 投放分析 — 每日
openclaw cron add --agent ads_analyst --cron "30 9 * * *" --task "每日投放 KPI 檢查"

# 資料分析 — 每日 + 每週
openclaw cron add --agent data_analyst --cron "0 20 * * *" --task "每日資料摘要"
openclaw cron add --agent data_analyst --cron "0 10 * * 1" --task "每週數據報告"

# 秘書 — 每日記憶壓縮
openclaw cron add --agent secretary --cron "0 23 * * *" --task "每日記憶壓縮與 State Diff"

5.2 事件觸發鏈(量化 pipeline

透過 CEO 的 Standing Orders 定義:

CEO Standing Order: 量化研究流程

當收到財經情報完成通知:
  → spawn market_structure_researcher

當收到市場結構報告完成通知:
  → spawn bullish_researcher平行
  → spawn bearish_researcher平行

當收到多方 + 空方報告都完成:
  → 執行 coordinator 討論(收集雙方觀點)
  → spawn quant_strategist帶入討論結果

當收到量化策略完成通知:
  → spawn quant_engineer

當收到回測完成通知:
  → spawn data_analyst

當收到資料分析完成通知:
  → send secretary做摘要
  → spawn reviewer審查整條 pipeline

當收到審查 pass
  → 組裝 Final_Decision_Packet
  → Discord @董事長 請求批准

當收到審查 revise
  → 退回被點名角色
  → 如超過 3 輪 → Discord @董事長 介入

第六部分:記憶架構

6.1 OpenClaw 記憶系統

層級 檔案/機制 用途
長期記憶 MEMORY.md 每個 agent 的永久知識session 啟動時自動載入
每日筆記 memory/YYYY-MM-DD.md 今日工作記錄,自動載入今天+昨天
夢境整合 DREAMS.md 可選,定期整合零散記憶
語意搜尋 memory_search 混合向量+關鍵字搜尋歷史記憶
跨 agent QMD extraCollections Agent A 搜尋 Agent B 的記憶

6.2 記憶分類與負責人

記憶類型 存放位置 寫入者 讀取者
董事長決策 CEO 的 MEMORY.md 秘書 所有 agentvia QMD
量化策略規則 quant_strategist 的 MEMORY.md 量化策略研究員 回測工程師、資料分析員
回測結果摘要 data_analyst 的 MEMORY.md 資料分析員 量化策略、CEO
品牌知識庫 strategy_director 的 MEMORY.md 策略總監 文案、創意
會議結論 secretary 的 memory/ 每日筆記 秘書 所有 agentvia QMD
個別工作脈絡 各 agent 的 memory/ 每日筆記 各 agent 該 agent + 秘書

6.3 記憶生命週期

類型 保留方式
MEMORY.md 永久,除非手動更新
每日筆記 自動載入今天+昨天;更舊的靠 memory_search
秘書壓縮 每日 23:00 將當日重點寫入 MEMORY.md清理冗餘

第七部分Discord Server 結構

7.1 頻道規劃

KingClawArmy Discord Server
│
├── 📋 管理
│   ├── #dashboard        — 每日摘要、系統狀態
│   ├── #approvals        — HITL 審批(你在這裡批准)
│   └── #errors           — 錯誤與異常
│
├── 📊 量化
│   ├── #quant-briefing   — 盤前盤後情報
│   ├── #quant-discussion — 討論區coordinator 討論結果貼這)
│   └── #quant-results    — 策略定稿、回測結果
│
├── 📈 行銷
│   ├── #marketing-intel  — 市場情報
│   └── #ads-performance  — 投放 KPI
│
├── ✏️ 內容
│   └── #content-briefs   — 文案 / 創意 brief
│
└── 📝 記錄
    ├── #meeting-logs     — 所有 coordinator 討論記錄
    └── #decision-log     — 重大決策

7.2 Discord 互動方式

你想做的事 怎麼做
下達新指令 在 #dashboard 或 DM 跟 CEO agent 說
查看進度 問 CEO 或秘書
批准高風險動作 在 #approvals 回覆 approve / reject
看今日摘要 #dashboard 自動推送(秘書每日產出)
看回測結果 #quant-results
手動發起討論 @CEO 說「召集量化團隊討論 [主題]」
緊急停止 openclaw tasks flow cancel <id> 或 Discord @CEO「停止 [任務]」

7.3 通知規則

事件 推送到 由誰推送
任務完成 對應區域頻道 CEO
審查 passHITL #approvals CEO
審查 block #errors + #approvals CEO
每日摘要 #dashboard 秘書
討論結論 #meeting-logs 秘書
錯誤/異常 #errors 相關 agent