小呆子调研：ClawTeam 与 OpenClaw 接入评估（清洗版）

结论

• ClawTeam 在 spawn 层已针对 OpenClaw 做了命令归一化（裸 openclaw 自动扩展为 openclaw agent --local）并为交互式模式追加 --session-id/--message，官方 README 也列为 “✅ Full support”，可直接作为平行管理代理接入。证据：clawteam/spawn/command_validation.py:41-53、clawteam/spawn/adapters.py:20-88、README.md:529-544。
• 团队通信统一走 TeamMessage（teammate-tool 规格）+ Mailbox + pluggable Transport，消息在 ~/.clawteam/teams/<team>/inboxes/<agent>/msg-*.json 内原子写入，可通过文件系统或 ZeroMQ P2P 同时被 ClawTeam、OpenClaw 消费与回执。证据：clawteam/team/models.py:15-142、clawteam/team/mailbox.py:15-194、docs/transport-architecture.md:3-89。
• 已依据 248 主机（假定为 Ubuntu22 + Python≥3.10）给出依赖、安装、配置、启动、验证与运维闭环方案，覆盖 Python 包、tmux/git、可选 pyzmq、OpenClaw CLI 及 snapshot/monitor 工具。证据：pyproject.toml:1-37、docs/skills/clawteam/references/cli-reference.md:12-120、clawteam/team/manager.py:90-161、clawteam/team/snapshot.py:109-220。

仓库结构与关键模块

• CLI：clawteam/cli/commands.py:2840-3039 负责 spawn，自动建队、分配 git worktree、注入协调提示并记录结果；同文件 1576-1692 暴露 team snapshot/snapshots/restore/snapshot-delete 为回滚提供入口。
• 团队元数据：clawteam/team/manager.py:90-161 创建/更新 team config 并为成员生成 inbox 目录，保证消息目录存在。
• 消息与传输：clawteam/team/mailbox.py:15-194 统一序列化/反序列化 TeamMessage 并调用 FileTransport/P2P；clawteam/transport/file.py:53-188 定义 inbox/死信目录与加锁读取，docs/transport-architecture.md:3-170 展示 file 与 ZeroMQ 双轨架构。
• API 暴露：clawteam/mcp/server.py:1-33 用 FastMCP 将 CLI 功能包装成工具，clawteam/mcp/tools/mailbox.py:1-88 对 send/broadcast/receive/peek/count 做了函数级封装，方便 OpenClaw 直接走 MCP。

OpenClaw 并行接入评估

• CLI 级适配：spawn 阶段会为 OpenClaw 命令补齐 --local、session id、message，从而让 OpenClaw 在收到 ClawTeam 注入的首个任务后即可通过自身 CLI 接管对话；无需手工包装。证据：clawteam/spawn/adapters.py:20-88。
• 消息对接能力：TeamMessage 字段覆盖 join_request/plan/shutdown/idle/broadcast，可映射 OpenClaw 管理面事件，且 MailboxManager 在 send 时会同时写 event log 供审计。证据：clawteam/team/models.py:50-122、clawteam/team/mailbox.py:48-151。
• 接口选择：① 直接 clawteam spawn tmux openclaw --team <team> 把 OpenClaw 作为“副指挥”加入现有队伍；② 在 OpenClaw 侧调用 clawteam-mcp 暴露的 mailbox_* 工具以编程方式取/发消息；③ 通过 clawteam inbox watch 以 --exec 钩子触发 OpenClaw 本地脚本，适合轻量联动。证据：README.md:529-544、clawteam/mcp/tools/mailbox.py:1-88、docs/skills/clawteam/references/cli-reference.md:107-120。
• 结论：无需修改源代码即可让 OpenClaw 并行管理 ClawTeam 团队；推荐模式是在 ClawTeam 中新增一个 openclaw-manager 代理（spawn），用 MCP 或 inbox 命令桥接消息，再由 OpenClaw 内部策略决定是否继续 fan-out 其他子代理。

248 主机部署与运维方案

• 前提：假设 248 主机为 Ubuntu 22.04/AlmaLinux 8 等 x86_64，具备 sudo、Python 3.10+、系统级 tmux/git/OpenClaw CLI；如不符合请相应替换包管理器。
• 依赖：Python>=3.10、pip、git、tmux、questionary（TUI）、rich/typer（自动安装）、OpenClaw CLI、自选 pyzmq（启用 P2P）。Python 依赖见 pyproject.toml:1-37，P2P 可选项见 pyproject.toml:30-37。
• 安装：

  sudo apt install -y python3.11 python3.11-venv tmux git
  git clone https://github.com/HKUDS/ClawTeam /opt/clawteam
  cd /opt/clawteam && python3.11 -m venv .venv && source .venv/bin/activate
  pip install -U pip && pip install ".[p2p]"

  如需系统级可 pip install clawteam。

• 配置：设置数据根和默认团队，例如 export CLAWTEAM_DATA_DIR=/data/clawteam、export CLAWTEAM_TEAM_NAME=openclaw-bridge；环境变量说明见 docs/skills/clawteam/references/cli-reference.md:12-26。未设置时默认写入 ~/.clawteam，clawteam/team/models.py:15-23 说明可通过 CLAWTEAM_DATA_DIR 覆写。
• 启动/验证：
  1. clawteam team spawn-team openclaw-bridge -n leader 初始化团队（docs/skills/clawteam/references/cli-reference.md:30-48）。
  2. clawteam spawn tmux openclaw --team openclaw-bridge --agent-name oc-manager --task "接收调度命令" 把 OpenClaw 纳入队伍（README.md:529-544）。
  3. 用 clawteam inbox send openclaw-bridge oc-manager "ping" / clawteam inbox receive openclaw-bridge --agent oc-manager 验证消息循环（docs/skills/clawteam/references/cli-reference.md:107-120）。
  4. 需要多主机联动时在 248 上 export CLAWTEAM_TRANSPORT=p2p 并确保 pyzmq 已装；ClawTeam 会读取 AgentIdentity 绑定 ZeroMQ 端口。证据：clawteam/team/mailbox.py:15-45、docs/transport-architecture.md:60-170。
• 运维：事件日志默认存于 ~/.clawteam/teams/<team>/events/evt-*.json 并由 Mailbox 写入（clawteam/team/mailbox.py:48-69）；可用 clawteam team snapshot/restore 做全量备份与回滚（clawteam/cli/commands.py:1576-1674、clawteam/team/snapshot.py:109-220）；clawteam inbox watch <team> --agent leader --exec '<OpenClaw 脚本>' 可实时触发外部操作（docs/skills/clawteam/references/cli-reference.md:107-120）。

接入架构与协议映射

OpenClaw CLI (clawteam spawn tmux openclaw --agent-name oc-manager)
    │ 通过 --message / --session-id 接收首个任务
    ▼
ClawTeam CLI (commands.py)
    │ 调用 MailboxManager.send/receive
    ▼
Transport (file / p2p) ───▶ inboxes/ & peers/  ───▶ 其他 ClawTeam 或 OpenClaw 节点

证据：clawteam/spawn/adapters.py:20-88、docs/transport-architecture.md:3-170。

程序化场景可直接运行 clawteam-mcp，OpenClaw 通过 MCP 调用 mailbox_send/receive，无需 shell。证据：clawteam/mcp/server.py:1-33、clawteam/mcp/tools/mailbox.py:1-88。

风险点与回滚方案

• 跨主机共享存储风险：FileTransport 依赖共享 inboxes/ 目录，若 248 与其他节点不共享磁盘则必须启用 P2P；否则消息会堆积/丢失。使用 pyzmq + CLAWTEAM_TRANSPORT=p2p 时 ZeroMQ 不可达会自动回退文件队列，但要监控 dead_letters/。证据：clawteam/transport/file.py:53-208、docs/transport-architecture.md:3-170。
• OpenClaw CLI 版本差异：ClawTeam 期待 openclaw agent 子命令可接受 --local/--session-id/--message；如社区版本变更应先独立验证命令，再通过 clawteam spawn subprocess openclaw ... 冒烟。证据：clawteam/spawn/command_validation.py:41-53、clawteam/spawn/adapters.py:60-73。
• 消息阻塞/文件锁：FileTransport 对 .consumed 文件做加锁，如果 OpenClaw 长时间持有锁可能导致队列阻塞；应监控 inbox 目录文件数并定期清理 dead_letters。证据：clawteam/transport/file.py:75-188。
• 配置/数据误操作：在修改模板、批量调度前运行 clawteam team snapshot <team>，必要时 clawteam team restore <team> <snapshot_id>；SnapshotManager 会在 dry-run 阶段展示即将恢复的任务/事件/消息数量，可用作回滚开关。证据：clawteam/cli/commands.py:1576-1674、clawteam/team/snapshot.py:123-219。

（via codex248 全自动调研）