子代理系统

概述

子代理（Subagent）是工作空间的任务分解与委托机制。主 Agent 可以将复杂的并行任务拆分为子任务，创建专门的子代理来独立执行，子代理完成后将结果返回给主 Agent 继续处理。

系统支持三种子代理类型，最大嵌套深度 3 级。

三种子代理类型

自动创建子代理（create_local_sub_agent）

Agent 在推理过程中判断当前任务需要分解时，会自主调用 create_local_sub_agent 工具创建临时子代理。用户也可以通过对话提示词要求 Agent 创建子代理，例如：

"请创建一个子代理来负责搜索相关资料，再创建另一个子代理来编写文档"

创建参数：

执行流程：

1. 主 Agent 决定创建子代理并指定任务
2. 系统启动独立的 Agent Loop（默认最大 50 轮）
3. 子代理拥有独立工具循环，执行过程在父对话窗口可见
4. 子代理完成后返回最终结果给主 Agent
5. 主 Agent 基于结果继续后续工作

预注册派发子代理（dispatch_sub_agent）

用户可在 APP 设置中预先注册具有特定配置的子代理，Agent 在需要时通过 dispatch_sub_agent 工具调用。

预注册子代理的描述会自动注入到主 Agent 的系统提示中，LLM 看到匹配的任务时会自动选择合适的子代理。

配置项：

管理界面详见 子代理注册与管理。

跨节点派发（dispatch_multi_node_agent）

当任务需要远程设备的资源或能力时，Agent 可通过 dispatch_multi_node_agent 工具将任务派发到其他节点执行。

工作流程：

1. 主 Agent 查看在线节点列表（注入到系统提示）
2. 根据节点能力声明选择目标节点
3. 通过 Gateway WebSocket 发送 node.invoke.request
4. 远程节点启动独立 Agent Loop 执行任务
5. 完成后通过 node.invoke.result 返回结果

场景示例：

• A 电脑上的 Web 端发起对话
• 任务需要访问 B 电脑上的本地文件
• Agent 通过 Gateway 将文件操作子任务派发到 B 电脑的 APP 节点
• B 节点执行后返回结果，A 电脑上继续展示对话

嵌套深度控制

子代理支持嵌套创建，最大深度 3 级：

                      
                      深度 0: 主 Agent（用户对话）
  └── 深度 1: 子代理 A
        └── 深度 2: 子子代理 A-1
              └── 深度 3: 最深层代理（不可再委派）

                    

深度越高，自主性越强，但 Token 消耗和执行时间也相应增加。

工具继承机制

UI 展示

子代理在 Claw 对话窗口中有特殊标记展示：

用户可以清晰看到哪些操作由主 Agent 执行、哪些由子代理执行。

如何通过对话创建子代理

你可以在对话中用自然语言要求 Agent 创建子代理。以下是一些示例提示词：

子代理执行中的界面解读

费用影响

子代理的 token 消耗是独立计算的：

建议：子代理适合真正需要分解的复杂任务。简单任务直接让主 Agent 处理即可，不必创建子代理。

什么时候该用 / 不该用子代理

SubAgent 不建议给于不同角色让其分工协作，在AI时代协作反而是降低效率和质量的。在并行任务执行以节省时间，提交效率的场景更加适合。

相关文档

• 子代理注册与管理 — 预注册子代理配置
• 多节点架构 — 跨节点派发的底层机制
• Agent 循环引擎 — 子代理使用的 Agent Loop