ClawTeam 多智能体协作
通过 clawteam CLI 将多个 AI 编码代理组成团队:建队、派活、消息传递、看板监控与 git worktree 隔离,一条命令实现多代理自动化。
文档披露了数据目录、快照/恢复、原子写入与 --no-skip-permissions 覆盖项,风险可见;但 spawn 默认开启 skip-permissions(自动跳过权限确认)、默认销毁式 inbox receive、自动生成 git worktree 并注入上下文,最小权限与用户确认机制不完整,扣分。
SKILL.md、CLI 参考与 workflows 三份文档相互一致,命令、选项、数据模型对齐,仓库含 CI 与针对 spawn 适配器的测试;但静态审查无法执行复现关键路径,错误处理与失败反馈证据不足,按静态上限计 10。
触发条件描述具体(spawn agent、任务板、多代理协调等),适用/不适用边界、依赖前提(tmux、git、CLI agent)清晰,含 moonshot-cn/minimax-cn 等中国可用预设与中文文档入口,环境适配证据较好,接近满分但缺实测验证。
分层文档(SKILL.md→references)、MIT 许可、版本号、已知限制与注意事项较完整,维护归属 HKUDS 可见;但 SKILL.md 标 0.3.1 而 pyproject 为 0.3.0,版本不一致,changelog/更新路径未随技能文档给出,扣分。
README 展示了多场景用例与命令式结果描述,多代理编排价值主张明确;但无静态可验证的实际输出物(无提交的结果文件、用例输出仅为叙述性截图/动图链接),静态上限 7 以下,扣分。
仓库含 GitHub Actions CI(多 OS/多 Python 版本)与覆盖 spawn 适配器、skip-permissions 映射的提交测试套件,属可审计一手材料;但测试未覆盖技能文档宣传的关键路径全貌(任务板、inbox、profile 等),静态上限 5。
- spawn 默认开启 skip-permissions,即子代理默认跳过权限确认,建议始终使用 --no-skip-permissions 或配置 skip_permissions=false 并在可信环境运行。
- inbox receive 为销毁式读取,误用会丢失消息,脚本中优先使用 inbox peek。
- 技能文档版本号(0.3.1)与包元数据(0.3.0)不一致,安装前核对实际发布版本。
- 静态审查未执行任何命令,可靠性/有效性结论基于文档与测试代码推断,使用前请自行小规模验证。
- 依赖外部 CLI agent(claude/codex 等)与 tmux,环境中缺任一前提技能将无法工作。
这个 Skill 能做什么,适合哪些场景?
ClawTeam 是一个框架无关的 CLI 工具,用于把多个 AI 代理(如 Claude Code、Codex、Gemini、Kimi、nanobot、OpenClaw)组织成一个协作团队。领导者代理通过 clawteam spawn 生成工作者代理,每个工作者自动获得独立的 git worktree、tmux 窗口和身份。团队共享任务看板(支持依赖链与优先级)、基于文件的收件箱消息系统,以及 tmux 平铺视图、自动刷新面板和 Web UI 等监控手段。所有状态以 JSON 文件存放在 ~/.clawteam/,无需数据库或服务器。该技能(SKILL.md v0.3.1)为代理提供使用这套 CLI 的完整指引。
通过 clawteam team spawn-team 创建团队,用 clawteam spawn 生成工作者代理(默认 tmux 后端 + claude 命令 + git worktree 隔离 + 跳过权限)。用 task create/update/list/wait 管理带依赖和优先级的共享任务看板;用 inbox send/broadcast/receive/peek 在代理间收发消息。preset 和 profile 命令配置非默认的模型提供商(如 Moonshot、MiniMax),board show/live/attach/serve 提供看板与实时监控,context conflicts/inject 在合并前检查跨 worktree 冲突,team snapshot/restore 支持快照恢复。所有命令支持 -- 输出,数据存储在 ~/.clawteam/。
- 使用 Claude Code 的开发者需要并行实现多个功能模块(如同时做 API、前端和测试),让领导者代理自动拆分任务并生成多个工作者代理
- 维护大型代码库重构的工程师,需要多个代理在各自 git worktree 中隔离工作,最后统一合并
- 需要使用非默认模型提供商(如通过 Moonshot Kimi 运行 Claude Code)的团队,用 preset/profile 生成可复用运行配置
- 希望在长任务中让代理持续轮询任务和收件箱而不是完成首个任务即退出的自动化工作流
- 想在合并前检查多个代理的修改是否冲突的团队负责人,使用 context conflicts 命令
这个 Skill 有哪些优点和局限?
- 框架无关:任何能执行 shell 命令的 CLI 代理都能参与,配合自动注入的协调提示无需自定义 SDK
- git worktree 隔离让并行代理互不冲突,分支可检查、合并
- 纯文件系统存储(~/.clawteam/ JSON 文件),无需 Redis、数据库或云服务
- 任务依赖链自动解除阻塞,支持优先级和 JSON 输出便于脚本化
- 内置快照/恢复、冲突检查、计划审批和优雅关闭等运维命令
- 依赖 tmux、git 仓库和已能独立运行的 CLI 代理——若代理本身无法运行,clawteam spawn 无法修复
- 默认 spawn 跳过权限(skip-permissions),需要用户主动用 --no-skip-permissions 关闭,存在安全考量
- Skill 文档未提供测试套件或跨平台验证证据;Cursor 支持在仓库层面标注为实验性
- inbox receive 为破坏性读取,误用可能丢失消息
- 文档未说明具体成本影响——多代理并行会成倍消耗模型调用
如何安装这个 Skill?
- 确认已安装 Python 3.10+、tmux 和至少一个 CLI 编码代理(如 claude)。2. 运行
clawteam --version检查是否已安装;若无,执行pip install clawteam(P2P 传输需pip install "clawteam[p2p]")。3. 技能文件位于仓库 docs/skills/clawteam/ 目录;README 提到安装脚本会将技能安装到检测到的客户端技能目录(如 ~/.claude/skills/clawteam),具体安装细节以仓库文档为准。
如何使用这个 Skill?
设置身份环境变量后创建团队并派活:
export CLAWTEAM_AGENT_ID="leader-001"
export CLAWTEAM_AGENT_NAME="leader"
export CLAWTEAM_AGENT_TYPE="leader"
clawteam team spawn-team my-team -d "Project team" -n leader
clawteam task create my-team "Design system" -o leader
clawteam spawn --team my-team --agent-name worker1 --task "Implement the auth module"
clawteam board attach my-team
或在代理对话中触发:提示词包含 "create a team"、"spawn agents"、"coordinate multiple agents",或任务复杂到适合拆分(如 "build a full-stack app"、"implement multiple features in parallel")时自动启用。注意 inbox receive 会消费消息,非破坏性读取用 inbox peek。
这个 Skill 与同类方案有什么区别?
README 将 ClawTeam 与其他多代理框架对比:其他框架面向人类编写编排代码,需要 Docker、云 API、Redis 等基础设施且绑定特定框架;ClawTeam 由 AI 代理自己通过 CLI 命令自组织,只需文件系统和 tmux,支持任意 CLI 代理,用 git worktree 而非容器做隔离。