Files
KingClawArmy/docs/spec/spec_system_overview.md
Chris 253f38a75e docs: 移除 v4 版號命名,新增 Paperclip 遷移規劃
- spec 檔案重新命名去除 v4 前綴
- 更新所有內部交叉引用
- 新增 migration_to_paperclip.md:概念對照、目標結構、Agent 定義、排程轉換
- INDEX.md 標記 OpenClaw 時期文檔為遷移參考用

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-10 15:32:07 +00:00

96 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 - 系統規格書
> 日期2026-04-09
> 狀態:定稿(遷移至 Paperclip 前的參考版本)
> 備註:原為純 OpenClaw 架構,現已決定遷移至 Paperclip
---
## 第一部分:系統總覽
### 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 用量 |