Files
KingClawArmy/docs/spec_v4_system_overview.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

97 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 用量 |