🌍 国际化（i18n）

默认英文，通过 ~/.openclaw/configs/team-dispatch.json 中 "language": "zh" 切换中文。

📊 任务分级

收到需求后，先判断复杂度：

🔀 拆解模板

根据需求类型自动选择：

开发类

安全敏感类（带部署）

研究类

全栈类

分析类

内容类

research(素材收集) → writer(初稿) → product(审核优化)

⚠️ 重要限制：sessions_spawn 可能不允许指定 agentId

在某些运行环境/工具策略下，sessions_spawn 可能会拒绝 agentId 参数（错误类似：agentId is not allowed for sessions_spawn (allowed: none)）。

此时 Team Dispatch 必须自动降级为“单 Agent 多角色模拟”模式：

• - 仍然按 DAG 拆解任务
• 派发时不传 agentId（让 subagent 继承当前 agent 身份）
• 在 task prompt 顶部注入角色指令（例如“你现在扮演 coder/product/tester…”）来模拟团队分工
• 结果收集、依赖解锁、重试逻辑保持不变

如果你有权限配置并希望启用真实多 Agent 派发：

• - 在 openclaw.json 中设置 agents.defaults.subagents.allowAgents: ["*"]（或允许列表）
• 重启 Gateway

⚙️ 核心调度流程

⚠️ 关键行为约定：事件驱动的自动调度循环
当你通过 sessions_spawn 派发任务后，OpenClaw 会在 subagent 完成时自动向你的会话推送一条 completion event（以 user message 形式到达）。
你必须在收到每一条 completion event 后，立刻执行完整的调度循环：

1. 1. 从 event 中提取 label，匹配到对应的 task
2. 更新该 task 的 status/result/completedAt，写入 JSON
3. 扫描所有 pending 任务，找出依赖已全部 done 的任务
4. 立刻派发这些就绪的任务（sessions_spawn）
5. 检查项目是否全部完成，若完成则归档并通知用户

不要等待用户指令，不要等待其他事件，不要跳过这个循环。每收到一条 completion event 就执行一次。
这是 Team Dispatch 的核心机制——事件驱动的级联派发。如果你不执行这个循环，任务就会"卡住"。

Step 1: 首次派发

扫描项目 JSON 中所有 status=pending 且依赖全部 done（或无依赖）的任务，批量派发：

CODEBLOCK14

Step 2: 收到 completion event → 立刻执行调度循环

当 subagent completion event 到达时（OpenClaw 自动推送，格式为 "✅ Subagent {agentId} finished\n{result}"），你必须立刻执行以下完整流程，不需要用户指令：

CODEBLOCK15

再次强调：Step 2 是一个自动触发的循环。你不需要也不应该等用户说"继续"或"下一步"。每收到一个 completion event，就执行一轮 ②→③→④。这样任务会像多米诺骨牌一样自动级联推进，直到全部完成。

Step 3: Prompt 构建 — 结果注入

下游 Agent 自动获得上游输出：

CODEBLOCK16

Step 4: 并行派发注意事项

当多个任务同时就绪时（如 t4-tests 和 t5-docs 都依赖 t3-core），应同时派发所有就绪任务，而非逐个等待：

CODEBLOCK17

🛡️ 故障处理

故障类型与自动恢复

降级策略（onFailure 字段）

📈 状态机

项目状态

任务状态

pending → in-progress → done
       → queued       → in-progress   (并发满)
       → in-progress  → failed → pending (重试)
                               → skipped (跳过)

🔒 并发控制

• - 并发上限由 agents.defaults.subagents.maxChildrenPerAgent/maxConcurrent 决定（默认 5，建议 10）
• 超出时任务进入 queued 状态，有 Agent 完成后自动出队
• 优先级：关键路径 > 依赖链长 > 声明顺序

🔗 依赖模式

⏸️ 用户确认点（XL 级）

关键节点暂停等用户审核：

CODEBLOCK20

INLINECODE75 类型不派发 Agent，暂停并通知用户。

📁 项目文件

存储路径：INLINECODE76

CODEBLOCK21

🔧 运维工具

✅ 闭环自测（最小协作链路）

1) 生成一个带 3 个任务的 Demo DAG（写入 ~/.openclaw/workspace/tasks/active/）：

CODEBLOCK22

2) 然后在 main agent 对话中说：

• - “请用 team-dispatch 跑一下刚生成的 demo-collab-loop 项目（product → coder → tester），并在完成后归档到 tasks/done。”

预期：main 会按依赖顺序依次 sessions_spawn(product/coder/tester)，并把结果写回项目 JSON，最终移动到 tasks/done/ 并汇总汇报。

✅ 闭环自测（协作开发测试 Demo）

生成一个最小可验证的协作开发 DAG 项目（默认 team-mvp-1），写入：~/.openclaw/workspace/tasks/active/：

CODEBLOCK23

生成后，在主 Agent 里发一句话触发调度（示例）：

请用 team-dispatch 跑一下刚生成的 team-mvp-1 demo 项目，按 DAG 依赖派发 product/coder/tester/writer，完成后归档到 tasks/done。

📋 完整调度示例

输入

自动处理

输出