子代理注册与管理
子代理注册与管理
概述
子代理管理页面用于预注册具有特定配置的子代理。预注册的子代理会自动注入到主 Agent 的系统提示中，Agent 在遇到匹配任务时自动选择调用。
预注册子代理配置
基本配置
| 参数 | 说明 | 必填 |
|---|---|---|
name |
子代理名称 | 是 |
description |
能力描述（注入到父 Agent 系统提示） | 是 |
systemPrompt |
身份/角色定义 | 是 |
工具配置
| 参数 | 说明 |
|---|---|
tools |
工具白名单（省略则继承父级全部工具） |
disallowedTools |
工具黑名单（在继承的基础上排除） |
skills |
可用技能 ID 列表 |
mcpServers |
可用 MCP 服务器名称列表 |
执行配置
| 参数 | 说明 | 默认值 |
|---|---|---|
model |
覆盖父级 LLM 模型 | 继承父级 |
maxTurns |
最大循环轮次 | 50 |
canSpawn |
是否可创建下级子代理 | false |
maxSpawnDepth |
最大嵌套深度（1-3） | 1 |
管理操作
| 操作 | 说明 |
|---|---|
| 添加 | 创建新的预注册子代理 |
| 编辑 | 修改现有子代理配置 |
| 删除 | 移除预注册子代理 |
| 排序 | 调整子代理在列表中的顺序 |
与 Claw 对话的联动
预注册的子代理通过以下方式与 Claw 对话联动：
- 系统提示注入：子代理的
name和description被列在主 Agent 的系统提示中 - 自动匹配：LLM 根据用户消息语义自动选择合适的子代理
- 手动调用：用户可在对话中指定使用某个子代理
使用场景示例
| 子代理名称 | 描述 | 专长工具 |
|---|---|---|
| 代码审查员 | 负责代码审查和质量分析 | Read File, Search Files, Glob |
| 文档编写者 | 负责撰写和格式化文档 | Write File, Edit, Web Fetch |
| 研究助手 | 负责信息搜索和资料收集 | Web Fetch, Search Files |
| 数据分析师 | 负责数据处理和分析 | Bash, Read File, Write File |
操作指南：创建预注册子代理
步骤
- 打开 APP → 设置 → 子代理
- 点击 添加子代理
- 填写基本信息：
- 名称：如"代码审查员"
- 描述：如"负责审查代码质量、发现潜在 bug 和优化建议"（此描述会注入主 Agent 系统提示，帮助 Agent 判断何时调用）
- 系统提示：如"你是一位资深代码审查专家，关注代码质量、性能、安全性和可维护性..."
- （可选）配置工具白名单/黑名单
- （可选）覆盖模型或调整 maxTurns
- 保存
配置示例："代码审查员"子代理
名称: 代码审查员
描述: 负责审查代码质量、发现潜在 bug、提供优化建议。擅长多语言代码分析。
系统提示: 你是一位资深代码审查专家。你的职责是：
1. 分析代码质量和可维护性
2. 发现潜在的 bug 和安全漏洞
3. 提供具体的优化建议
请对每个问题给出严重等级（低/中/高）和修复建议。
工具白名单: Read File, Search Files, Glob Files（只需要读取能力，不需要修改）
模型: Claude Sonnet 4（推理能力强）
maxTurns: 30
canSpawn: false（不需要再委派）
名称: 代码审查员
描述: 负责审查代码质量、发现潜在 bug、提供优化建议。擅长多语言代码分析。
系统提示: 你是一位资深代码审查专家。你的职责是：
1. 分析代码质量和可维护性
2. 发现潜在的 bug 和安全漏洞
3. 提供具体的优化建议
请对每个问题给出严重等级（低/中/高）和修复建议。
工具白名单: Read File, Search Files, Glob Files（只需要读取能力，不需要修改）
模型: Claude Sonnet 4（推理能力强）
maxTurns: 30
canSpawn: false（不需要再委派）
此代码块在浮窗中显示
maxSpawnDepth 的实际影响
| 设置 | 含义 | 适用场景 | 费用影响 |
|---|---|---|---|
| 1（默认） | 子代理不能再创建下级子代理 | 简单的专项任务 | 低 |
| 2 | 子代理可以再创建一层子代理 | 中等复杂任务，需要二次分解 | 中 |
| 3 | 最大嵌套深度，允许三级委派 | 高度复杂的多步骤任务 | 高（每级子代理独立消耗 token） |
注意：每一级子代理都会启动独立的 Agent Loop（默认 50 轮），消耗独立的 LLM token。深度 3 意味着最多可能有 4 个 Agent 同时运行（主 + 3 级子代理），费用可能是单 Agent 的数倍。
预注册 vs 自动创建：怎么选？
| 对比 | 预注册（dispatch_sub_agent） | 自动创建（create_local_sub_agent） |
|---|---|---|
| 配置 | 预先配置好，一劳永逸 | Agent 每次按需临时创建 |
| 一致性 | 每次使用相同配置，结果稳定 | Agent 每次可能给不同的身份和工具 |
| 适合场景 | 经常重复使用的专业角色 | 一次性的临时任务分解 |
| 系统提示 | 自动注入主 Agent，Agent 知道可以使用 | Agent 自主决定是否创建 |
建议：如果某类任务你经常需要（如代码审查、文档编写、数据分析），创建预注册子代理。对于偶尔的临时任务分解，让 Agent 自动创建即可。
相关文档
- 子代理系统 — Claw 中的子代理使用
- 工具管理 — 子代理可用的工具
- Agent 循环引擎 — 子代理使用的 Agent Loop