企业官网建设流程全解析

1. 为什么单 Agent 干不完复杂任务，ClawTeam 能补上这块

ClawTeam 是一个框架无关的多智能体协调框架，它让 Claude Code、Codex、Kimi CLI 这类命令行 Agent 像一支真实小队一样分工干活：一个 Leader 负责拆任务、派活、验收，多个 Worker 并行执行子任务，彼此通过文件系统收件箱通信。它适合谁？适合已经用单个 CLI Agent 写代码、做数据分析，但一遇到「改 5 个文件 + 跑评测 + 回滚 + 再迭代」这种长链路就卡住的人。单个 Agent 的上下文窗口是有限的，任务一长，它要么忘掉前面的约束，要么把多个目标混在一起改得面目全非。ClawTeam 的思路很朴素：把大目标拆成有依赖关系的小任务，交给不同 Agent 并行做，用 Git Worktree 隔离代码改动，用任务状态机控制先后顺序。

我试过用单个 Agent 连续改一个评测脚本，改到第三轮它就开始重复劳动、忘记基线数值。换成 ClawTeam 的 Leader-Worker 结构后，Leader 常驻负责读评测结果、决定下一轮改哪里，Worker 每次都是全新实例、带着完整背景启动，反而稳定得多。这篇教程就按「从零搭一个可复用 Agent 团队」的路径走：先接好统一 Key，再写 config.toml 和 settings.json 骨架，然后跑通任务分发与结果验证。全程命令可复制，你跟着敲就能跑起来。

2. 前置准备：用 TaoToken 统一 Key 接入多智能体

多智能体最烦的一件事是：Leader 用 Claude，Worker 用 Codex，另一个 Worker 用 Kimi，每个都要单独配 Key、单独记端点、单独算账。TaoToken 在这里的作用是提供一个统一的 API 入口，你申请一个 Key，就能在多个模型之间切换调用，省掉到处找 Key 的麻烦。官网入口在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 基址是 https://taotoken.net/api （这个地址不加 UTM 参数）。

接入前先确认三件事：Python 3.10+、tmux、git 都已安装，并且至少有一个 CLI Agent 可用。然后安装 ClawTeam：

pip install clawteam # 可选：需要跨机器低延迟通信时再装 pip install clawteam[p2p]

验证安装是否成功：

clawteam --version clawteam config health

config health会检查 tmux、git、以及已注册的 CLI Agent 是否就绪。如果它提示某个 Agent 找不到，先确认那个 CLI 本身能单独跑起来。接下来去 TaoToken 控制台创建 API Key，入口是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，Key 列表页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。拿到 Key 后不要写死在脚本里，用环境变量注入：

export TAOTOKEN_API_KEY="sk-你的key"

ClawTeam 的所有数据默认存在~/.clawteam/下，团队配置、收件箱、任务文件都在里面，后面排查问题基本都围绕这个目录。

3. 可复制配置：config.toml 与 settings.json 骨架

ClawTeam 的配置分两层：全局配置和团队配置。全局配置决定默认用哪个模型端点，团队配置决定这个团队有哪些角色、各自干什么。先写全局的~/.clawteam/config.json，把 TaoToken 作为统一入口：

{ "default_provider": "taotoken", "providers": { "taotoken": { "base_url": "https://taotoken.net/api", "api_key_env": "TAOTOKEN_API_KEY", "models": { "leader": "claude-sonnet-4-6", "worker_fast": "codex-mini", "worker_reason": "kimi-k2" } } }, "storage_dir": "~/.clawteam", "default_backend": "tmux" }

这里的关键是api_key_env指向环境变量名而不是明文 Key，团队里所有 Agent 共用这一个入口，切换模型只改models字段。然后是团队模板~/.clawteam/templates/dev-team.toml，它定义了一个可复用的开发团队：

[template] name = "dev-team" description = "通用开发团队：Leader 规划，两个 Worker 并行实现" command = ["claude"] backend = "tmux" [template.leader] name = "tech-lead" type = "leader" task = """ 你是开发团队的 Leader。目标：{goal} 职责： 1. 把目标拆成有依赖关系的任务，用 clawteam task create 创建 2. 给每个任务指定 owner 和优先级 3. 用 clawteam spawn tmux <agent> --replace 启动 Worker 4. 用 clawteam inbox receive 读取 Worker 汇报，评估结果 5. 永不停止，直到收到 shutdown 信号 """ [[template.agents]] name = "backend-dev" type = "worker" task = """ 你是后端开发 Worker。目标：{goal} 执行分配给你的任务，完成后： 1. git add -A && git commit -m "描述" 2. clawteam task update {team} {task_id} --status completed 3. clawteam inbox send {team} tech-lead "完成报告：改动=..., 结果=..." """ [[template.agents]] name = "qa-engineer" type = "worker" task = """ 你是测试 Worker。目标：{goal} 对后端产出做验证，发现问题用 inbox 汇报给 tech-lead。 """

如果你更习惯用 JSON 描述运行时设置，可以额外放一份~/.clawteam/settings.json作为覆盖层，ClawTeam 会优先读它：

{ "runtime": { "poll_interval_seconds": 10, "task_wait_timeout": 1800, "skip_permissions": true }, "workspace": { "use_worktree": true, "auto_checkpoint": true }, "cost": { "budget_usd": 20.0 } }

skip_permissions在自动化场景里基本必开，否则 Claude Code 每步都弹确认，团队根本跑不动。use_worktree打开后每个 Worker 有独立分支，并行改代码不会互相覆盖。配置写完先自检：

clawteam config health clawteam template list

模板列表里能看到dev-team就说明骨架生效了。

4. 跑通第一个团队：任务分发与结果验证

配置就绪后，用模板一键拉起团队。假设目标是「给一个 FastAPI 项目加用户认证模块」：

clawteam launch dev-team \ --team auth-demo \ --goal "为 FastAPI 项目实现 JWT 用户认证，包含注册、登录、刷新 token 三个接口，并写单元测试"

launch会自动创建团队、启动 Leader、按模板创建初始任务。启动后立刻开一个看板窗口盯进度：

clawteam board attach auth-demo

这个 tmux 平铺视图会同时显示 Leader 和所有 Worker 的终端，你能直接看到谁在改哪个文件。如果只想看任务状态，用：

clawteam board live auth-demo --interval 5

手动分发任务的完整流程是这样的，适合你想精确控制时用：

# 1. 建团队 clawteam team spawn-team auth-demo -d "认证模块开发" -n tech-lead # 2. 建任务，指定 owner 和优先级 clawteam task create auth-demo "设计认证接口文档" -o tech-lead -p high # 假设返回任务 ID: t1 # 3. 建依赖任务，未完成前自动 blocked clawteam task create auth-demo "实现注册登录接口" -o backend-dev -p high --blocked-by t1 clawteam task create auth-demo "编写认证单元测试" -o qa-engineer -p medium --blocked-by t1 # 4. 启动 Worker clawteam spawn tmux claude \ --team auth-demo \ --agent-name backend-dev \ --repo /path/to/project \ --task "实现 JWT 注册、登录、刷新 token 接口，完成后提交并汇报" clawteam spawn tmux codex \ --team auth-demo \ --agent-name qa-engineer \ --repo /path/to/project \ --task "为认证接口编写 pytest 单元测试，覆盖正常和异常路径"

任务依赖是 ClawTeam 很实用的一个点：t1没完成时，后面两个任务状态是blocked，Worker 不会白跑。当 Leader 把t1标记完成：

clawteam task update auth-demo t1 --status completed

依赖它的任务会自动变成pending，对应 Worker 就能开工。验证结果分两步，先看任务状态：

clawteam task list auth-demo --sort-priority clawteam task stats auth-demo

再读 Worker 的汇报消息：

clawteam inbox receive auth-demo --agent tech-lead

一条合格的完成报告长这样：完成报告：任务=实现注册登录接口，改动=auth.py 新增 3 个路由，测试=5 passed，建议=刷新 token 需加过期校验。如果报告里只有「已完成」三个字，说明 Worker 的 task 描述不够具体，回去把验收标准写进--task里。代码层面用 worktree 隔离后，合并前先看差异：

clawteam workspace status auth-demo --agent backend-dev clawteam context diff auth-demo --agent backend-dev clawteam workspace merge auth-demo backend-dev

5. 本篇常见报错排查

报错一：clawteam: command not found。多半是 pip 装的脚本目录不在 PATH 里。用python -m clawteam --version验证是否装上了，能跑就说明是 PATH 问题，把 pip 的 bin 目录加进环境变量即可。

报错二：config health提示 tmux not found。ClawTeam 的交互式 Agent 依赖 tmux 承载终端会话。Ubuntu 下sudo apt install tmux，macOS 下brew install tmux。装完重开终端再跑一次 health。

报错三：Worker 启动后立刻退出，inbox 消息没人处理。这是最常见的误区。Codex、Kimi 这类 Agent 完成任务后会退出进程，你往它的收件箱发消息不会把它唤醒。正确做法是用--replace启动全新实例，并把完整背景写进--task：

clawteam spawn tmux codex \ --team auth-demo \ --agent-name qa-engineer \ --replace \ --task "新任务：为刷新 token 接口补异常测试。项目路径 /path/to/project，当前基线 5 passed，完成后跑 pytest 并汇报前后结果"

报错四：多个 Worker 改同一文件互相覆盖。检查 spawn 时有没有加--no-workspace。加了它 Agent 直接在主仓库干活，自然冲突。去掉它，让每个 Agent 走独立 worktree，最后用workspace merge合并。

报错五：调用模型返回 401 或鉴权失败。先确认TAOTOKEN_API_KEY在当前 shell 里真的存在：echo $TAOTOKEN_API_KEY。如果为空，说明 export 只在另一个终端生效了。再确认config.json里base_url写的是https://taotoken.net/api，末尾不要多加斜杠或路径。需要重新生成 Key 就去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。

报错六：任务一直卡在 blocked。用clawteam task list auth-demo --status blocked看它依赖哪个任务，再查那个前置任务的状态。常见原因是前置任务的 owner 已经退出但没标记 completed，手动补一条clawteam task update即可解锁。

报错七：成本超预期。先设预算上限clawteam cost budget auth-demo 20.0，再定期clawteam cost show auth-demo看哪个 Agent 花得多。通常 Leader 常驻轮询是消耗大头，把poll_interval_seconds调大能省不少。

6. 把团队配置沉淀成可复用资产

跑通一次之后，真正省时间的是把配置沉淀下来。团队快照能让你在重构前存档、出问题回滚：

clawteam team snapshot auth-demo --tag before-refactor clawteam team snapshots auth-demo clawteam team restore auth-demo --snapshot before-refactor

模型接入这块，如果你想让 Leader 用推理强的模型、Worker 用快的模型，可以在 TaoToken 的模型对话页先对比一下不同模型在同一任务上的表现，入口是 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，确认哪个组合性价比高再写进config.json的models字段。需要长期跑编码类 Agent 任务、频繁 spawn Worker 的场景，可以了解下 Coding Plan，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，它更适合这种持续多轮调用的用法。接入细节和参数说明统一看文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，Claude Code 相关的接入方式在 https://taotoken.net/claudecode?utm_source=taotoken_aicg_blog_end&utm_content=claudecode&utm_campaign=rewrite 。

最后给一个我踩过坑后固定下来的习惯：每次 spawn Worker 前，先把「验收标准」写进--task，比如「跑 pytest 全绿且新增测试不少于 3 条」，而不是「写测试」。Worker 是无状态的，它只能按你给的文字干活，背景越完整，返工越少。团队跑完记得收尾：

clawteam lifecycle request-shutdown auth-demo clawteam team cleanup auth-demo --force

把dev-team.toml这个模板留着，下次换个--goal就能直接复用，这才是多智能体团队真正省事的地方。