ClawTeam × OpenClaw 深度整合 Spec

创建：2026-03-30 状态：草案，待老大审批

1. 愿景

一句话：OpenClaw 当大脑，ClawTeam 当四肢。

老大说"去做这个"
    ↓
小武（OC dc-main）拆任务、派发
    ↓
ClawTeam 执行层：spawn agent → mailbox 通信 → agent 自主协商分工
    ↓
agent 干完 → lifecycle 回调 → webhook 通知 Discord
    ↓
小武汇总报告

agent 之间自己聊、自己分工、自己解决冲突。小武只管"发令"和"收报告"，不当传话筒。

2. 现状问题

Discord 编排模板（已废弃）

• 依赖 Discord API 发消息、建帖子、读回复
• 频道权限、帖子创建失败、消息丢失、API 限流
• agent 之间通过 Discord 频道"对话"，延迟高、不可靠
• 老大评价："boom shit"

Bridge v2（当前）

• 中央调度模式：router.py 决定谁干什么
• executor 之间不交流，只有 context.json 单向传递
• 本质是"自动化的手动派发"，不是真正的协同

缺什么

• agent 之间的实时通信
• agent 自主决策能力（拆任务、认领、求助）
• leader 角色的自动化（现在是小武手动当 leader）

3. ClawTeam 可用的模块

啃完源码后确认，以下模块可以直接用：

4. 架构设计

4.1 角色分工

┌─────────────────────────────────────────────┐
│  OpenClaw (小武 dc-main)                      │
│  角色：Leader / 总控                           │
│  职责：接收老大指令 → 拆任务 → 派发 → 收报告    │
│  不做：不介入 agent 之间的协商                   │
└──────────────┬──────────────────────────────┘
               │ SSH + ClawTeam Python API
               ▼
┌─────────────────────────────────────────────┐
│  248 WSL - ClawTeam 执行层                    │
│                                              │
│  ┌──────────┐  mailbox  ┌──────────┐        │
│  │ codex    │◄────────►│ kiro     │        │
│  │ (worker) │  互相通信  │ (worker) │        │
│  └────┬─────┘          └────┬─────┘        │
│       │                     │               │
│       ▼                     ▼               │
│  ┌──────────────────────────────────┐       │
│  │ 共享基础设施                       │       │
│  │ - FileTransport (消息传输)        │       │
│  │ - TaskStore (任务状态)            │       │
│  │ - InboxWatcher (事件监听)         │       │
│  │ - LifecycleManager (生命周期)     │       │
│  └──────────────────────────────────┘       │
│                    │                         │
│                    ▼                         │
│  InboxWatcher --exec → webhook → Discord     │
└─────────────────────────────────────────────┘

4.2 OC 接管 Leader 的方式

不改 ClawTeam 的 leader agent 逻辑，而是：

1. OC 注册为 team 的 leader member
2. OC 通过 ClawTeam Python API 直接操作：
   • TaskStore.create() — 创建任务
   • MailboxManager.send() — 给 agent 发指令
   • SpawnBackend.spawn() — 启动 agent
   • TaskStore.list_tasks() — 查进度
3. agent 完成后通过 mailbox 发消息给 leader（OC）
4. InboxWatcher 监听 leader inbox，--exec 触发 webhook

这样 OC 不需要常驻进程在 248 上，只在需要时 SSH 过去调 API。

4.3 Agent 自主协商流程

ClawTeam 的 agent prompt 里已经内置了协调协议：

agent 启动后自动：
1. clawteam task list → 看自己的任务
2. clawteam task update → 标记 in_progress
3. 干活
4. 遇到问题 → clawteam inbox send leader "Need help: ..."
5. 需要队友配合 → clawteam inbox send teammate "请帮我 review ..."
6. 干完 → clawteam task update → completed
7. clawteam inbox send leader "All tasks completed. 摘要..."
8. 空闲 → clawteam lifecycle idle
9. 循环检查 inbox 和 task list

这就是你想要的：agent 自己聊、自己分工。

5. 魔改清单

5.1 必须改的（最小集）

5.2 可选改的

5.3 不改的

6. 实施步骤

Phase 1：安装 + 基础验证

1. 248 WSL 上 pip install clawteam（或从源码装我们的 fork）
2. 创建 team：clawteam team create wolf-pack
3. 注册 OC 为 leader：clawteam team join wolf-pack --name oc-leader
4. 手动 spawn 一个 codex agent，验证 mailbox 通信
5. 验证 inbox watch --exec 能触发 webhook

Phase 2：OC 侧封装

1. 写 oc_bridge.py：SSH 封装 ClawTeam API 调用
2. 写 oc_leader.py：接收老大指令 → 拆任务 → 调 ClawTeam API 派发
3. 测试：老大说"写个脚本" → 小武拆任务 → ClawTeam spawn codex → codex 干完 → webhook 通知

Phase 3：多 Agent 协同

1. 同时 spawn codex + kiro
2. 验证 agent 之间通过 mailbox 自主通信
3. 验证 codex 写完代码后主动发消息给 kiro 请求 review
4. 验证 kiro review 后发现问题能通知 codex 修复

Phase 4：生产化

1. 错误处理 + 超时 + 死亡检测
2. 成本追踪（clawteam cost report）
3. 看板集成（board serve 或自定义静态看板）
4. 与现有 bridge v2 的迁移/共存策略

7. 与现有 Bridge v2 的关系

共存，不替代。

• Bridge v2 继续处理简单的单任务派发（调研、单文件编码）
• ClawTeam 处理需要协同的复杂任务（多文件开发、代码+review+修复循环）
• 两者共享 248 的 codex/kiro 执行环境
• 未来可以让 Bridge v2 作为 ClawTeam 的"快捷通道"——简单任务不走 spawn，直接调 executor

8. 风险

9. 成功标准

老大说"给我写个 XXX 功能"，小武一键派发，codex 和 kiro 自己商量怎么干，干完自动通知，老大看到成品。

全程零传话筒、零手动协调、零 Discord 编排。

待老大审批。这是个大活，建议分 Phase 推进，每个 Phase 验证通过再下一步。