小呆子调研：重新深度调研仓库 https://github.com/HKUDS/ClawTeam 。本次唯一重点

结论

• ClawTeam 的 NativeCliAdapter.prepare_command 原生识别 openclaw 可执行体并自动补齐 --local/--session-id/--message 等参数，OpenClaw 作为子进程即可被 ClawTeam 控制且无需额外包装（clawteam/spawn/adapters.py:23-112）。
• 控制面暴露 CLI（clawteam task/*, inbox/*, team/*）与 FastMCP 工具集，均支持 --json 输出版式，OpenClaw 只需运行命令或接入 MCP 客户端即可发号施令（clawteam/cli/commands.py:1150-2290；clawteam/mcp/server.py 与 clawteam/mcp/tools/init.py）。
• 状态/消息被落盘在 ~/.clawteam 下，由 get_data_dir、FileTaskStore、FileTransport 提供锁/原子写，OpenClaw 只要与 ClawTeam 共享同一数据目录或通过 p2p transport 即可观测与回放（clawteam/team/models.py:10-60；clawteam/store/file.py；clawteam/transport/file.py）。
• 需满足：OpenClaw 常驻一条控制 session（用于调用 MCP 或 clawteam --json）；ClawTeam 运行在 OpenClaw 可访问的宿主；若需 UI/回执，则开启 board SSE 或 inbox watch --exec 把消息回推到 OpenClaw。

接入架构

• 控制流：OpenClaw 通过 shell/MCP 发出 clawteam task create|update 等命令，TeamManager 负责成员/队列定位，再由 FileTaskStore 把任务写入 JSON 并根据依赖自动置位 blocked／pending（clawteam/cli/commands.py:1898-2050；clawteam/team/manager.py:20-210；clawteam/store/file.py:create/update/_resolve_dependents）。
• 执行流：clawteam spawn ... --agent-name <worker> 使用 SpawnBackend + NativeCliAdapter 把 OpenClaw/其他 CLI agent 拉起，并在 spawn_registry.json 中登记 PID 与 tmux 窗口供 liveness 检测（clawteam/cli/commands.py:2800-3080；clawteam/spawn/registry.py）。
• 消息与状态流：工作节点通过 MailboxManager.send/receive 写入 teams/<name>/inboxes/<agent>/msg-*.json，FileTransport 负责 claim/ack/死信，事件还会被 _log_event 记入 teams/<name>/events/ 供追溯（clawteam/team/mailbox.py；clawteam/transport/file.py）。
• 观测/回执流：BoardCollector 聚合任务、成员、消息、成本，board/server.py 提供 /api/team/<name> 与 SSE；TaskWaiter 在 task wait 中轮询任务并探测死进程，必要时把 in_progress 任务重置为 pending（clawteam/board/collector.py 与 board/server.py；clawteam/team/waiter.py）。若需把事件推回 OpenClaw，可使用 inbox watch --exec，InboxWatcher 会把消息字段注入 CLAWTEAM_MSG_* 环境变量后执行外部命令（clawteam/team/watcher.py）。

MVP 步骤（248 主机）

1. ssh 248 && cd /data/agents && python3 -m venv .venv && source .venv/bin/activate，随后 pip install -e ./ClawTeam openclaw（依赖来自 pyproject；MCP 入口为 python -m clawteam.mcp，见 clawteam/mcp/main.py）。
2. export CLAWTEAM_USER=$USER 并用 clawteam team spawn-team main-squad -n controller 建立控制组，命令见 team_spawn_team（clawteam/cli/commands.py:1150-1195）。
3. 启动 MCP 服务供 OpenClaw 连接：python -m clawteam.mcp --stdio（FastMCP 注册工具在 clawteam/mcp/server.py）；OpenClaw 在其配置里把 clawteam MCP 加入即可。
4. 由 OpenClaw（或人工）执行 clawteam spawn tmux openclaw --team main-squad --agent-name builder --task "…" 拉起受控 worker，spawn_agent 会自动写入 worktree/身份（clawteam/cli/commands.py:2800-3080）。
5. 控制面发送任务并实时监听：clawteam --json task create main-squad "Review PR" --owner builder，并在另一终端运行 clawteam inbox watch main-squad --agent controller --exec 'openclaw agent --session control --message "$CLAWTEAM_MSG_JSON"' 将回执转交 OpenClaw（inbox_watch 定义于 clawteam/cli/commands.py:1852-1885；执行逻辑在 clawteam/team/watcher.py）。
6. 如需面向用户的可视化/状态轮询，在 248 上运行 clawteam board serve --port 8090 --default-team main-squad，OpenClaw 轮询 /api/team/main-squad 或 SSE 渠道即可反馈进度（clawteam/board/server.py）。

失败 / 重试 / 幂等 / 超时 / 回滚

• FileTaskStore 通过 _write_lock + atomic mkstemp 写任务，release_stale_locks 会扫描死 Agent 并清空 locked_by，保证重复执行 task update 幂等（clawteam/store/file.py:23-170, 200-260）。
• MailboxManager 与 FileTransport 的 claim_messages + ClaimedMessage.ack/quarantine 机制，可在 OpenClaw 控制端失败时简单重拉，未 ack 的消息会保留，坏包会进 dead_letters（clawteam/team/mailbox.py:60-170；clawteam/transport/file.py:90-210）。
• TaskWaiter.wait(timeout=…) 允许 OpenClaw 设置总超时，并在 _check_dead_agents 中调用 list_dead_agents 把孤儿任务重置为 pending，从而支持自动重试（clawteam/team/waiter.py:20-160）。
• SnapshotManager/team snapshot|restore 提供完整数据回滚，包含任务、事件、会话、收件箱，必要时 TeamManager.cleanup 可清空残留 worktree/task/costs 重新部署（clawteam/team/snapshot.py；clawteam/team/manager.py:185-230）。

接口映射

Checklist

• [ ] 在 248 完成 ClawTeam + OpenClaw 安装并确认 python -m clawteam.mcp 能被 OpenClaw 发现。
• [ ] 设定 CLAWTEAM_DATA_DIR 与 CLAWTEAM_AGENT_* 并通过 clawteam identity show 校验。
• [ ] 建立首个 team（team spawn-team）并通过 team status/board serve 验证可观测数据。
• [ ] 试跑 clawteam spawn tmux openclaw … 并确认 spawn_registry.json 与 task wait 可检测其存活。
• [ ] 配置 inbox watch --exec 或 board SSE → OpenClaw 转发链路，确保回执能送达终端用户。
• [ ] 建立每日 team snapshot + dead_letter 检查流程，验证回滚与消息重放链条。

（via codex248 全自动调研）