OpenClaw SubAgents Creator — OpenClaw 子代理创建器

OpenClaw 子代理配置技能概述 配置和管理 OpenClaw 子代理 —— 主代理生成的后台代理，在隔离会话中运行，并在完成后报告结果。该技能涵盖了从单个子代理生成到全面的多代理编队管理。

参考资料 在配置过程中根据需要加载以下文件： references/config-reference.md —— 完整的 openclaw.json 模式用于子代理（所有字段、默认值、每个代理的覆盖） references/sessions-spawn-tool.md —— 会话生成工具的参数、斜杠命令和行为详细信息 references/agent-files.md —— SOUL.md、AGENTS.md、HEARTBEAT.md 和内存文件模板 references/multi-agent-architecture.md —— 深度级别、工具访问规则、公告链和任务控制集成

步骤 1：确定设置类型 询问或从上下文中推断出用户需要的模式： 模式 描述 maxSpawnDepth 单个子代理 主代理生成一个后台工作线程 1（默认） Orchestrator 主代理 -> 编排器 -> 工作线程（嵌套） 2 多代理编队 多个独立代理共享一个任务数据库 1 个代理

步骤 2：配置 openclaw.json 配置文件位于 ~/.openclaw/openclaw.json。加载 references/config-reference.md 以获取完整的模式。 最小子代理配置： { agents: { defaults: { subagents: { model: "anthropic/claude-haiku-4-5", // 使用更便宜的模型用于子代理 maxSpawnDepth: 1, // 设置为 2 用于编排器模式 maxChildrenPerAgent: 5, // 每个会话的最大活动子代理（1-20） maxConcurrent: 8, // 全局并发限制 runTimeoutSeconds: 900, // 在 N 秒后中止（0 = 无限制） archiveAfterMinutes: 60 // 在 N 分钟后自动删除转录 }, }, list: [ { id: "main", workspace: "~/.openclaw/workspace-main" } ] } } 有关每个代理的模型覆盖和工具限制，请参阅 references/config-reference.md。

步骤 3：创建代理身份文件 每个代理工作区在 ~/.openclaw/workspace-/ 下需要身份文件。加载 references/agent-files.md 以获取完整的模板。 文件 目的 注入到子代理中？ SOUL.md 个性、角色、语音 否 AGENTS.md 操作程序、工具、任务控制 是 HEARTBEAT.md唤醒检查清单 是（通过 cron 消息） memory/WORKING.md 当前任务状态 代理维护此文件 memory/MEMORY.md 长期策划的事实 代理维护此文件

步骤 4：设置 Cron 心跳 每个代理每 15 分钟唤醒一次通过 cron。将代理分散 2 分钟： openclaw cron add \ --name "agent-heartbeat" \ --cron "0,15,30,45 " \ --session "isolated" \ --message "您是 ，。阅读 WORKING.md。检查任务控制中的 @mentions 和分配的任务。如果有工作，请执行并更新 WORKING.md。如果没有工作，请回复 HEARTBEAT_OK。" 建议的分散时间表用于编队： :00 代理 1（例如 Pepper） :02 代理 2（例如 Shuri） :04 代理 3（例如 Friday） :06 代理 4（例如 Loki） :08 代理 5（例如 Vision）

步骤 5：生成子代理 子代理以非阻塞方式生成 —— 工具立即返回运行 ID，结果在完成后公告。 从代理内部（代理调用会话生成工具，带有这些参数）： task: "研究竞争对手的定价 #42 并将发现的结果发布为评论" agentId: "researcher" // 可选：目标特定代理 label: "竞争对手研究" // 可选：人类可读的名称 model: "claude-haiku-4-5" // 可选：覆盖模型 thinking: "none" // none | basic | deep runTimeoutSeconds: 600 // 可选：在 N 秒后中止 cleanup: "delete" // 删除 = 立即在公告后存档 mode: "run" // 运行 = 单次（默认），会话 = 持久 手动通过斜杠命令： /subagents spawn researcher "研究竞争对手的定价 #42" 加载 references/sessions-spawn-tool.md 以获取完整的参数详细信息。

步骤 6：验证和监控 openclaw agents list --bindings # 确认代理路由 openclaw gateway start # 启动网关守护进程 在聊天中： /subagents list # 查看活动运行 /subagents info # 状态、时间戳、会话密钥 /subagents log [limit] # 执行日志 /subagents steer # 重定向中间运行 /subagents kill # 停止子代理 + 级联到子代理

工具访问按深度（关键） 深度 会话密钥格式 是否可以生成会话工具 可用的工具 0 agent::main 总是 所有工具 1 agent::subagent: 仅当 maxSpawnDepth >= 2 时 会话生成、子代理、会话列表、会话历史（仅编排器） 2 agent::subagent::subagent: 从不 没有

常见陷阱 永远不要在代理之间共享 agentDir —— 身份验证配置文件 sessions_list、sessions_history、sessions_send、sessions_spawn 默认对所有子代理阻塞。