- 人工智能
- AI Agent
- 多智能体
- Agent 编排
- 代码智能体
- CLI
【免费下载链接】ClawTeam-OpenClaw
ClawTeam fork fully adapted for OpenClaw — multi-agent swarm coordination with OpenClaw as the default agent
想不想让一群 AI 智能体像真正的团队一样分工协作?ClawTeam 是一个开源的多智能体协作框架(本项目为深度适配 OpenClaw 的 fork 版本),你用一条条clawteam命令就能完成建队、派单、监控、交付全流程——你只负责定目标,智能体群自己拆任务、发消息、合并成果。本文就带你从零组建第一个多智能体团队,跑通完整实战。
一、ClawTeam 多智能体协作:一句话让 AI 自己组队
大多数 AI 编程智能体都是"单打独斗":一个会话、一个目录、各干各的。ClawTeam 的思路是让智能体自己组织成团队:
| 角色 | 干什么 |
|---|---|
| 👑 Leader(领导智能体) | 拆分任务、派单、审批、合并成果 |
| 🛠️ Worker(工作者智能体) | 领任务、干活、汇报进度、互相通信 |
它的工作方式非常直观,看下面这张漫画就懂了:
支撑这套"团队"运转的四个核心概念:
- Teams(团队):一个有名字的成员组,含一个 leader 和若干 worker;
- Tasks(任务看板):共享看板,任务在
pending → in_progress → completed / blocked间流转,支持--blocked-by依赖链; - Inbox(收件箱):智能体之间的点对点消息队列;
- Workspace(工作区):每个智能体拥有独立的git worktree隔离分支,并行开发互不干扰。
所有状态都存在本地~/.clawteam/目录的 JSON 文件里——不需要数据库,不需要服务器,安装即用。
二、环境准备:3 条命令装好 ClawTeam
2.1 先确认依赖
ClawTeam 需要Python 3.10+和至少一个 CLI 智能体(本 fork 默认使用 OpenClaw),Linux/macOS 上完整可视化体验还需要tmux:
python --version # 需要 3.10+ tmux -V # Linux/macOS 需要 openclaw --version # 或 claude / codex 等2.2 安装 ClawTeam
⚠️ 注意:不要直接
pip install clawteam(那会装到上游 PyPI 版本,没有 OpenClaw 适配),也不要装同名的 npm 包。请从仓库源码安装:
git clone https://gitcode.com/gh_mirrors/cl/ClawTeam-OpenClaw cd ClawTeam-OpenClaw pip install -e . # 从本地仓库安装,关键一步嫌步骤麻烦?仓库自带一键安装脚本(覆盖安装、技能注册、审批配置等步骤 2–6):
bash scripts/install-openclaw.sh对应脚本见 install-openclaw.sh。
2.3 验证安装
clawteam --version # 能打印版本号即可 clawteam config health # 全绿表示环境健康💡 小贴士:spawn 出来的智能体运行在全新 shell 里,可能找不到
clawteam。建一个软链接可保万无一失:ln -sf $(which clawteam) ~/bin/clawteam并确认~/bin在 PATH 中。
三、建队:创建你的第一个智能体团队
一条命令建队,-d写团队目标,-n指定 leader 名字:
clawteam team spawn-team my-team -d "Build the auth module" -n leader建好之后随时可以查看团队:
clawteam team discover # 列出所有团队 clawteam team status my-team # 查看成员团队生命周期管理(发现、加入审批、快照、清理等)的完整逻辑在 manager.py 中实现,官方还整理了 6 套标准工作流,值得收藏:workflows.md。
四、派单:创建任务、设置依赖、派发指令
4.1 创建带依赖链的任务
这是多智能体协作的精髓——用--blocked-by声明任务依赖,前置任务完成后自动解除阻塞:
# 任务1:设计 API(leader 自己做) clawteam task create my-team "Design API schema" -o leader # 假设返回 Task ID: aaa11111 # 任务2:后端实现(依赖任务1,自动置为 blocked) clawteam task create my-team "Implement backend" -o alice --blocked-by aaa11111 # 紧急任务可用 --priority high clawteam task create my-team "Hotfix bug" --priority high4.2 用收件箱派发指令
Leader 给每个 worker 发消息,就像发工位纸条:
clawteam inbox send my-team alice "Wait for API schema, then implement OAuth2 flow" clawteam inbox broadcast my-team "Sprint starts now!" # 全员广播4.3 更新与查询任务
clawteam task update my-team aaa11111 --status completed # 完成时自动解除下游阻塞 clawteam task list my-team --status blocked # 看被卡住的任务 clawteam task wait my-team --timeout 300 # 阻塞等待全部完成五、召唤智能体:spawn 出你的第一支 AI 团队
重头戏来了。spawn一条命令,一个完整的 worker 就诞生了——自带独立 git worktree、独立 tmux 窗口、独立身份:
clawteam spawn --team my-team --agent-name alice --task "Implement OAuth2 flow" clawteam spawn --team my-team --agent-name bob --task "Write unit tests for auth"spawn 的默认行为已经调得很贴心:
| 设置 | 默认值 | 说明 |
|---|---|---|
| 后端 | tmux | Windows 上自动降级为subprocess |
| 工作区 | 自动创建 git worktree | 分支命名clawteam/{team}/{agent} |
| 权限 | 跳过确认 | 智能体不会被权限弹窗卡住 |
| 身份 | 自动注入环境变量 | worker 无需手动配置就知道自己是"谁" |
📌 worker 的标准工作循环:查任务 → 收消息 → 干活并更新状态 → 空闲时上报 leader。这个循环协议写在官方技能文件 SKILL.md 里,OpenClaw 安装技能后会自动遵守。
六、看板监控:4 种方式盯紧团队进度
团队跑起来后,你只需要"看"。ClawTeam 提供 4 种监控姿势,由轻到重:
| 命令 | 效果 | 适合场景 |
|---|---|---|
clawteam board show my-team | 终端静态看板 | 快速一瞥 |
clawteam board live my-team --interval 3 | 终端自动刷新 | 命令行党 |
clawteam board attach my-team | tmux 平铺所有智能体画面 | 想看每个 worker 实时在干嘛(Linux/macOS/WSL) |
clawteam board serve --port 8080 | 浏览器 Web UI,实时更新 | 手机/远程围观,Windows 用户首选 |
Web 看板服务实现在 server.py,还支持clawteam board gource my-team --live生成团队活动可视化动画,看着智能体们"干活"非常治愈。
💡 跨机器协作?把
CLAWTEAM_TRANSPORT切换为 P2P(ZeroMQ)即可,架构细节见 transport-architecture.md。
七、交付收尾:合并分支、审批与团队清理
7.1 合并成果
每个 worker 的成果都在自己的 worktree 里,完成后由 leader 合并回主干:
clawteam workspace list my-team # 查看所有工作区 clawteam workspace merge my-team alice # 把 alice 的分支合回 main clawteam workspace cleanup my-team alice # 清理 worktree合并前建议先跑一下冲突检查(clawteam context conflicts my-team),避免并行改动撞车。
7.2 优雅收尾
clawteam team snapshot my-team --tag before-refactor # 大改动前打快照 clawteam team restore my-team --snapshot before-refactor # 一键回滚 clawteam team cleanup my-team --force # 项目结束,解散团队📌 需要"先审后干"的团队,可以用
plan submit / approve / reject让 worker 提交方案、leader 审批后再执行,见 workflows.md 的 Workflow 4。
八、进阶:一条命令拉起行业模板团队
会手动建队之后,你可以尝试"模板一键组队"——TOML 文件里定义好角色、任务、提示词,一条launch命令整队拉起来。内置模板包括:
clawteam template list # 查看可用模板 clawteam launch hedge-fund --team fund1 --goal "Analyze AAPL, MSFT, NVDA for Q2 2026"上面这条命令会拉出一支7 人投资团队:5 个分析师(价值、成长、技术面、基本面、情绪面)并行分析,风险经理汇总信号,组合经理拍板决策。模板源码可参考 hedge-fund.toml,照着写一个就能拥有自己的领域团队。
更硬核的真实案例:有用户用 ClawTeam 让8 个智能体跑在 8 张 H100 上做自主模型优化,30 个 GPU 小时、2430+ 次实验,把指标改善了 6.4%:
九、常见问题排查清单
| 问题 | 原因 | 解决办法 |
|---|---|---|
clawteam: command not found | pip 的 bin 目录不在 PATH | 建~/bin软链接并加入 PATH |
clawteam --version显示 "Coming Soon" | 装到了 npm 同名的无关包 | npm uninstall -g clawteam后按第二节重装 |
| 智能体卡在权限确认弹窗 | OpenClaw 审批模式是 "full" | 按 README Step 5 切到 "allowlist" 并加白clawteam |
| worker 收不到指令 | 前 60 秒 inbox 通常为空 | 稍等后再clawteam inbox peek my-team |
更多细节可查阅项目根目录的 README.md,OpenClaw 用户的完整使用指南在 skills/openclaw/SKILL.md。
写在最后
回顾一下你刚跑通的完整链路:
装环境 →team spawn-team建队 →task create派单(带依赖)→spawn召唤智能体 →board看板监控 →workspace merge合并交付
整套流程不需要写一行编排代码、不需要 Docker 和消息队列,全部建立在文件系统和 git 之上。下一步,不妨试试给团队加一条--blocked-by依赖链,或者照 hedge-fund.toml 写一个属于你自己的领域模板——多智能体团队的上限,由你的想象力决定。🦞
- 人工智能
- AI Agent
- 多智能体
- Agent 编排
- 代码智能体
- CLI
【免费下载链接】ClawTeam-OpenClaw
ClawTeam fork fully adapted for OpenClaw — multi-agent swarm coordination with OpenClaw as the default agent
相关推荐
Toonflow 团队脚手架实战:从 team.json 清单到标准 A2A 服务的多智能体团队构建指南
Toonflow 团队脚手架实战:从 team.json 清单到标准 A2A 服务的多智能体团队构建指南 @toonflow/teams scaffold 是
人工智能AI 应用AI AgentRAGAI 写作后端桌面应用CrewAI终极指南:掌握Agent、Task与Crew三大核心组件的完整教程
CrewAI终极指南:掌握Agent、Task与Crew三大核心组件的完整教程 CrewAI是一个革命性的AI代理协作框架,通过精心设计的Agent(代理)、T
人工智能AI AgentAgent 框架多智能体工作流自动化后端CrewAI 核心入门:用 Crew 编排你的第一个多智能体 AI 团队
CrewAI 核心入门:用 Crew 编排你的第一个多智能体 AI 团队 本篇技术指南围绕 CrewAI 框架中最核心的概念 —— Crew (智能体团队管理器
人工智能AI 应用AI Agent
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考