# KingClawArmy AI Agent Team - 系統規格書 v4

> 版本：v4.0  
> 日期：2026-04-09  
> 狀態：初版定稿  
> 前版差異：v3 為 Paperclip + Discord + Mem0 多系統架構，v4 簡化為純 OpenClaw 架構

---

## 第一部分：系統總覽

### 1.1 系統目標

建立一個 AI Agent 團隊（代號 KingClawArmy），能夠：

1. **量化研究**：情報蒐集 → 市場結構分析 → 多空辯論 → 策略形成 → 回測 → 分析
2. **行銷策略**：市場研究 → 品牌/成長策略 → 投放分析
3. **內容創作**：策略 → 文案撰寫 → 視覺方向
4. **工程開發**：前端/後端（依需求啟用）
5. **自主協作**：Agent 之間能交換資訊、討論、產出 1+1 > 2 的效果

### 1.2 設計原則

| 原則 | 說明 |
|---|---|
| **一套系統** | 全部用 OpenClaw，不疊加外部系統 |
| **Model-Agnostic** | 不綁定任何 AI 模型，雲端或本地皆可 |
| **漸進式上線** | 一隻一隻加入，觀察調整再擴編 |
| **人類保留最終決策權** | 高風險動作必須經過董事長批准 |
| **討論產生價值** | 關鍵決策點安排多 Agent 協作 |

### 1.3 整體架構

```
┌────────────────────────────────────┐
│            你（董事長）              │
│      Discord 管理 + HITL 審批       │
└─────────────────┬──────────────────┘
                  │
┌─────────────────▼──────────────────┐
│           OpenClaw Gateway          │
│                                     │
│  ┌─ Agent 管理 ──────────────────┐ │
│  │  agent routing + bindings     │ │
│  │  sub-agent 派工               │ │
│  │  sessions_send 溝通           │ │
│  └───────────────────────────────┘ │
│                                     │
│  ┌─ 任務與排程 ──────────────────┐ │
│  │  Task Flow 任務管理           │ │
│  │  Cron 排程（5/6 欄位 + 時區） │ │
│  │  Hooks 事件觸發（13+ 類型）   │ │
│  │  Standing Orders 常駐指令     │ │
│  └───────────────────────────────┘ │
│                                     │
│  ┌─ 記憶 ────────────────────────┐ │
│  │  MEMORY.md 長期記憶           │ │
│  │  daily notes 每日筆記         │ │
│  │  memory_search 語意搜尋       │ │
│  │  QMD/Honcho 跨 agent 記憶     │ │
│  └───────────────────────────────┘ │
│                                     │
│  ┌─ 工作流 ──────────────────────┐ │
│  │  Lobster DSL 多步驟流程       │ │
│  │  審批 gate + timeout          │ │
│  └───────────────────────────────┘ │
│                                     │
│  ┌─ 整合 ────────────────────────┐ │
│  │  Discord 完整整合             │ │
│  │  MCP 3,200+ skills            │ │
│  │  30+ 通訊平台                 │ │
│  └───────────────────────────────┘ │
│                                     │
│  ┌─ 模型（隨你接）──────────────┐ │
│  │  Claude / GPT / DeepSeek      │ │
│  │  Gemini / 本地 Ollama / vLLM  │ │
│  └───────────────────────────────┘ │
└─────────────────────────────────────┘
```

### 1.4 為什麼只用 OpenClaw

| 之前考慮的工具 | 為什麼不需要 |
|---|---|
| Paperclip | OpenClaw 的 agent routing + Task Flow + cron 已涵蓋調度；Discord 已涵蓋管理介面 |
| Mem0 | OpenClaw 內建記憶 + QMD/Honcho 跨 agent 記憶已足夠 |
| AutoGen | 群組辯論用 coordinator 模式替代；等 OpenClaw #18869 實裝後原生支援 |
| n8n | OpenClaw cron + hooks 已涵蓋排程與事件觸發 |

### 1.5 已知限制

| 限制 | 影響 | 緩解方式 |
|---|---|---|
| 無原生群組辯論（#18869） | 3+ agent 即時辯論不支援 | coordinator 模式串行替代，或等原生支援 |
| 無視覺化管理 UI | 沒有漂亮 dashboard | Discord slash commands + CLI 管理 |
| 無 per-agent 預算 dashboard | 成本追蹤不方便 | 自訂 skill 追蹤 token 用量 |