多 Agent 协同是 Claw 模式的核心能力之一，允许用户在同一个应用中配置多个分工不同的子 Agent，由主 Agent 统一调度，共同完成单个 Agent 难以覆盖的复杂任务。Claw 模式提供以下两种协同机制，用户可按需选择：
单向委派（默认机制）：主 Agent 拆解任务、分发给子 Agent，子 Agent 执行后回传结果，最终由主 Agent 整合输出。适合意图分流、批量并行调研等场景。
团队协作（进阶能力，需手动开启）：在单向委派的基础上，为已有子 Agent 开放双向直接通信与主动协作能力，适合跨角色闭环、长流程多模块协作等场景。开启后 Token 消耗显著高于单向委派。
单向委派机制
工作原理
单向委派是 Claw 模式默认的协同机制：主 Agent 作为决策中心，负责理解用户意图、自动拆解并分发任务；子 Agent 负责执行并返回结果，最终由主 Agent 整合输出回复。
单向委派下，子 Agent 之间不能直接通信，所有信息必须经主 Agent 中转；子 Agent 为被动执行角色，无法主动发起交互。
设置方式
第一步：配置主 Agent
主 Agent 是整个应用的调度中心，负责理解用户意图、决定路由或拆解策略。
1. 配置名称：主 Agent 名称默认与应用名称保持一致。
2. 配置提示词：应明确描述其调度职责和转发逻辑，包括：
如何根据用户输入判断应路由至哪个子 Agent
无法确定路由时的兜底处理策略
最终输出时如何整合各子 Agent 的结果
3. 配置模型：建议主 Agent 选择能力较强的模型，以保证路由判断和结果综合的准确性。
4. 配置 Skills、工具与连接器：主 Agent 可根据需要配置，用于兜底处理子 Agent 无法覆盖的场景。
第二步：添加子 Agent
1. 在左栏 子 Agent 区域，单击 添加子 Agent。
2. 填写子 Agent 基础配置：
配置项 | 说明 |
Agent 名称 | 简洁、含义明确地描述该 Agent 的职责领域。名称是主 Agent 判断路由的关键依据之一。例如：售前咨询 Agent、工单处理 Agent。 |
Agent 描述 | 简要说明该 Agent 的能力范围和典型处理场景，帮助主 Agent 判断何时将任务路由至该 Agent。描述越清晰，路由准确率越高。支持单击 AI 一键优化 自动优化描述（消耗 Agent 模型的 token）。 |
提示词 | 约束该 Agent 的任务边界、执行步骤和输出格式。应聚焦于其职责范围内的任务处理逻辑。 |
模型 | 选择适合其任务特性的模型，可与主 Agent 使用不同模型。 |
Skills | 为该 Agent 添加单独的技能。单 Agent 最多 80 个。 |
连接器与工具 | 单 Agent 最多 1000 个工具（含连接器），连接器以工具为单位计入上限。 |
3. 单击 保存，子 Agent 添加完成。
注意：
单个应用主 Agent 与子 Agent 合计最多 20 个（即最多 19 个子 Agent）。
子 Agent 配置完成后，主 Agent 可根据其名称和 Agent 描述自动判断路由时机，无需手动维护路由规则。
第三步：验证协同效果
添加子 Agent 后，在右侧调试区域发起测试对话，验证主 Agent 的路由行为是否符合预期：
调试建议：
1. 分别输入各子 Agent 职责范围内的典型问题，验证主 Agent 是否准确路由。
2. 输入多个子 Agent 均可能处理的边界问题，观察主 Agent 的判断策略。
3. 如路由不准确，优先优化对应子 Agent 的名称和 Agent 描述，使其与目标场景语义更匹配。
4. 如主 Agent 在某类问题上持续路由错误，在主 Agent 提示词中补充针对该类问题的明确路由指令。
调度策略
调度策略由系统根据已配置的子 Agent 数量自动选择，无需手动设置：
场景 | 调度策略 | 工作方式 |
仅 1 个子 Agent | 1 对 1 路由 | 主 Agent 根据用户意图判断是否路由至该子 Agent；命中则转发，未命中则主 Agent 自行处理。 |
多个子 Agent | 并行分发 | 主 Agent 将任务拆解为多个子任务，并行分发给对应子 Agent；各子 Agent 独立执行后，主 Agent 综合所有结果输出最终回复。 |
开启团队协作
工作原理
团队协作是在单向委派基础上的进阶能力。开启后，子 Agent 不再只是被动接收任务的执行角色，而是获得两项新增能力：一是可与主 Agent 双向沟通（主动反馈、确认、请求补充信息），二是子 Agent 之间可直接通信、无需事事经主 Agent 中转。
设置方式
第一步：开启团队协作
1. 在左栏底部的 高级设置 区域，找到 允许多 Agent 团队协作 开关。
说明：
开关默认关闭。关闭时仅可用单向委派；开启后系统自动选择单向委派或团队协作。
已创建 Claw 模式应用并配置至少一个子 Agent。
团队协作复用已有子 Agent 配置，开启开关后系统自动在运行时扩展团队协作能力，无需修改已有子 Agent 配置。Agent 数量上限同单向委派。
第二步：配置团队协作规则
开启开关后会弹出 团队协作规则 界面（或单击开关旁边的设置图标打开），用于填写主 Agent 的调度和团队组建逻辑。
说明：
团队协作规则将作为主 Agent 的调度指令。
建议在规则中将主 Agent 称为 Lead（队长）、子 Agent 称为 Teammates（团队成员），让模型更清楚各自角色。主 Agent 与各子 Agent 自身的职责、工具与人设，请在各自的 Agent 配置页中配置。
第三步：调试团队协作
开启并配置协作规则后，在中栏调试预览区发起多角色协作测试：
1. 协作链路验证：输入需要多个子 Agent 协作完成的典型任务，观察协作流程是否按预期执行。
2. 边界场景验证：测试子 Agent 之间任务衔接的边界情况，例如：一个子 Agent 完成任务后，其他子 Agent 是否能准确感知并接续处理。
3. 优化迭代：根据调试结果优化团队协作规则、Agent 描述和提示词，提升协作准确率。
开启团队协作后，调试预览区会展示协作过程信息，包括哪些子 Agent 被激活、任务流转路径、各子 Agent 的执行状态。
调度策略
在单向委派调度策略之上，开启团队协作后，系统会根据任务特征自动选择合适的通信方式：
通信方式 | 工作方式 | 典型场景 |
主-子双向 | 子 Agent 可与主 Agent 双向沟通，但子 Agent 之间不直接对话 | 多角色协作但不需要子 Agent 之间直接沟通的场景，如多角度并行审查 |
子 Agent 互连 | 子 Agent 之间可直接双向对话，无需经主 Agent 中转 | 需要子 Agent 之间实时协调的场景，如客服处理 → 建工单 → 归档知识库 |
两种模式能力对比
能力 | 单向委派 | 团队协作 |
通信方向 | 主 Agent → 子 Agent（单向） | 主 Agent ↔ 子 Agent、子 Agent ↔ 子 Agent（双向） |
子 Agent 自主性 | 被动接收任务 | 可主动反馈、确认 |
子 Agent 之间直接通信 | 不支持 | 支持 |
共享任务列表，自主认领 | 不支持 | 支持 |
配置复杂度 | 低 | 中（需配置团队协作规则） |
Token 成本 | 低 | 约为单向委派的 2~3 倍 |
是否默认开启 | 是 | 否（需手动开启开关） |
适用场景与选型建议
任务特征 | 典型例子 | 建议 |
按领域分流 | 售前咨询→售前 Agent；售后问题→售后 Agent | 保持单向委派 |
一次性并行调研/汇总/验证 | 调研多家供应商价格与交期并行汇总；整合一周医保政策对比各省 | 保持单向委派 |
多角色协作、需要子 Agent 主动反馈 | 内容运营：选题→撰稿→审校→返修 | 开启团队协作 |
子 Agent 之间需要直接对话协调 | 客服→工单→知识库全链路 | 开启团队协作 |
多角度并行审查（互相挑刺） | 安全/性能/测试子 Agent 同时审查同一方案 | 开启团队协作 |
研究与调研、互相质疑补充 | 多个子 Agent 调查同一问题不同方面后共享发现 | 开启团队协作 |
新模块并行开发、互不干扰 | 前端/后端/测试各由不同子 Agent 负责衔接发布 | 开启团队协作 |
简单问答、单轮固定对话 | 单一客服问答 | 不启用多 Agent |
固定业务流程、步骤确定 | 报销审批、订单流转 | 使用工作流模式 |
Token 成本高度敏感 | 低价值任务、高频调用 | 保持单向委派 |
不适用场景（建议改用单 Agent 或单向委派）：
顺序型任务：步骤之间必须严格按顺序执行、前一步没完成后一步无法开始，开启团队协作只会增加协调开销，不产生并行收益。
同一目标的密集修改：多个子 Agent 同时改同一份内容（如同一份文档、同一份代码文件）会互相覆盖、产生冲突，应交给单个 Agent 完成。
依赖关系密集的工作：任务之间有大量前置依赖，子 Agent 大部分时间在等彼此，团队协作的并行优势无法发挥。
说明：
如果你的任务拆开后，子 Agent 之间需要频繁互相等待、或经常改同一处内容，团队协作帮不上忙，甚至更慢更贵。这种场景请用单 Agent 或单向委派。
常见问题
1. 子 Agent 路由不准确，如何优化？
优先检查并优化以下两个配置项：
Agent 名称：确保名称直接、明确地描述职责领域，避免泛化名称（如"助手 Agent"）。
Agent 描述：补充具体的触发条件和典型场景，例如："负责处理用户关于产品功能咨询的问题，包括功能使用方法、功能限制说明、功能对比等"。
如优化上述配置后仍存在路由问题，可在主 Agent 提示词中明确添加路由规则，例如：「当用户询问产品价格时，路由至"报价 Agent"；当用户询问售后服务时，路由至"售后 Agent"」。
2. 开启团队协作后，原有子 Agent 配置是否需要重新设置？
不需要。团队协作复用已有子 Agent 配置，开启开关后系统自动在运行时扩展双向协作能力，无需修改已有子 Agent 名称、描述、提示词等。建议开启后重新检查各子 Agent 的描述，确保准确反映其职责范围。
3. 团队协作模式下 Token 消耗明显增加，如何控制成本？
确认业务场景确实需要团队协作，避免在单向委派能满足需求的场景下开启团队协作。
精简子 Agent 数量，只配置业务流程中真正需要的角色。
在子 Agent 提示词中明确限制其行为边界，减少不必要的跨子 Agent 通信。
系统会对单次任务 Token 消耗设置上限，超限后自动降级处理。
4. 如何查看团队协作模式下子 Agent 之间的通信过程？
开启团队协作后，调试预览区会展示协作过程信息，包括哪些子 Agent 被激活、任务在各角色间的流转路径、各子 Agent 的实时执行状态。可据此判断协作流程是否符合预期，并优化子 Agent 配置。
