乐于分享
好东西不私藏

OpenClaw 子代理全解:让 AI 分身并行干活,同时搞研究、写代码、查数据

OpenClaw 子代理全解:让 AI 分身并行干活,同时搞研究、写代码、查数据

0. 引言

前 11 篇,你的 AI 已经能聊天、查数据、操作浏览器、定时自动干活、越用越聪明了。但它还有个致命问题——

它一次只能干一件事。

你让它”帮我查一下 AAPL 的股价,顺便总结一下最近的 AI 新闻,再写封邮件”——它只能一个一个来,串行执行。

今天这篇,带你解锁 OpenClaw 的子代理系统(Subagents)——让 AI 学会”分身术”,同时派多个分身去干活,最后汇总结果。

打个比方:

阶段
AI 的工作模式
像什么
前 13 篇
AI 一个人干所有事
一个能力超强的打工人
第 12 篇(今天) AI 能派分身同时干活 打工人有了团队,能同时推进多个任务
💡 子代理 = 给 AI 组建一支”分身小队”,从”个人英雄”变成”团队指挥官”。

1. 什么是子代理?

1.1 一句话告诉你:子代理就是 AI 分身术

子代理是你让 AI 在后台启动的独立分身——它有自己的会话、自己的上下文、自己的工作要做,干完活后把结果汇报给你。

1.2 核心特点有什么?隔离、并行、自动汇报

特点
说明
并行执行
可以同时启动多个子代理,各自独立工作
隔离运行
每个子代理在独立的会话中运行,互不干扰
自动汇报
干完活后自动把结果推送回你的聊天窗口
不阻塞主会话
启动后你可以继续和主 AI 聊天,不用等
不能嵌套
子代理不能再生子代理(防止无限套娃)

1.3 什么时候用子代理?

别纠结,记住这个原则:

耗时 > 1 分钟 且不需要你参与的任务 → 交给子代理

典型场景:

场景
适合子代理?
原因
查股票实时行情
几秒钟的事,没必要
研究一个课题(搜 20+ 篇文章)
耗时且不需要交互
批量处理 100 个文件
耗时长
写一封邮件
你可能要改内容
对比 5 个产品的参数
纯数据工作

2. 子代理需要开启配置吗?

💡 答案:不需要。子代理功能默认开启,开箱即用。

只要你装了 OpenClaw,子代理功能就已经在后台等着了——不需要额外的安装、不需要改配置、不需要开开关。

ℹ️ 版本要求:子代理是 OpenClaw 核心内置功能,2026.1.5 起就已内置,只要不是特别旧的版本都能直接用。

2.1 默认配置一览

OpenClaw 给子代理预设了一套合理的默认值:

配置项
默认值
说明
功能开关
✅ 默认开启
不需要任何配置即可使用
最大并发数
8 个
最多同时运行 8 个子代理
嵌套深度
1 层
子代理不能再生子代理(防止套娃)
单会话子代理上限
5 个
每个主会话最多同时有 5 个子代理
超时时间
0(不限制)
子代理可以一直运行,直到任务完成
自动归档
60 分钟
子代理完成后 60 分钟自动清理
子代理模型
继承主 AI
默认使用和主 AI 相同的模型
💡 大多数用户不需要改任何配置——直接跟 AI 说需求就行。只有想省钱(限制并发数、用便宜模型)或特殊场景(嵌套编排)才需要调配置。

2.2 怎么确认子代理功能可用?

不确定你的 OpenClaw 有没有子代理功能?两步验证:

⚠️ 注意:以下命令在 OpenClaw 聊天框 中输入,不是 CMD/PowerShell 终端命令。

方法一:查看子代理列表

/subagents list

如果返回空列表或正常输出 → 功能可用 ✅

如果返回错误提示 → 需要检查 OpenClaw 版本是否太旧

方法二:启动一个测试子代理

/subagents spawn default "请回复:子代理功能正常"

几秒后收到回复 → 功能正常 ✅

2.3 什么时候需要改配置?

场景
需要改配置?
改什么
正常使用(跟 AI 说需求)
不需要
想省钱
设置子代理用便宜模型、限制并发数
需要子代理再生子代理
设置 maxSpawnDepth: 2
子代理跑飞了想限制时间
设置 runTimeoutSeconds
想禁止子代理用某些工具
设置 tools.subagents.tools.deny

需要改配置的场景,看第 8 章「进阶配置」和第 7 章「成本优化」。


3. 怎么启动子代理?

3.1 方法一:直接跟 AI 说”帮我开个子代理”

最简单的方式——直接告诉 AI:

“帮我研究一下 OpenClaw 的子代理功能,搜一下网上有什么教程”

AI 会自动判断是否需要启动子代理来完成这个任务。它背后会这样操作:

阶段
发生什么
你看到什么
① 你说完话
AI 识别到”研究”是耗时任务
你继续等,不需要额外操作
② AI 判断
决定启动子代理来处理
聊天界面提示”正在启动子代理…”
③ 子代理运行
后台搜索网页、阅读文章、整理信息
你可以继续和主 AI 聊天,不受影响
④ 自动汇报
子代理完成后推送结果
聊天窗口收到一份完整研究报告
💡 核心理解:你只管说需求,AI 自己判断要不要开分身、开几个、用模型跑——不需要你手动配置。

3.2 方法二:一条 /subagents 命令搞定

⚠️ 注意:以下命令在 OpenClaw 聊天输入框中直接输入(webchat、Discord、Telegram、飞书等),不是在 CMD/PowerShell 终端中执行。

如果你习惯用命令:

# 启动一个子代理/subagents spawn default "帮我研究一下 OpenClaw 子代理功能"# 指定模型(用便宜模型省钱)/subagents spawn default "帮我研究一下 OpenClaw 子代理功能" --model qwen-turbo# 指定思考级别/subagents spawn default "帮我分析一下这个复杂的代码" --thinking high

3.3 方法三:AI 自己决定开分身

子代理开起来之后,怎么知道它们在干什么?能不能中途改主意、关掉头?

当你在对话中同时给出多个耗时任务时,AI 可能会用工具并行启动多个子代理:

你:"帮我同时做三件事:1. 研究最近 30 天的 AI 新闻2. 分析一下 AAPL 的技术指标3. 写一份项目总结"AI 内部操作:→ 子代理 1:研究 AI 新闻→ 子代理 2:分析 AAPL→ 子代理 3:写项目总结→ 三个同时开始,干完各自汇报

4. 管理子代理

启动子代理后,你可以随时查看和管理它们:

4.1 查看正在运行的子代理

⚠️ 以下命令同样在 OpenClaw 聊天框 中输入,不是终端命令。
# 列出所有子代理/subagents list# 查看某个子代理的信息/subagents info 1# 查看某个子代理的日志/subagents log 1# 查看最近 50 行日志,包含工具调用/subagents log 1 50 tools

4.2 steer:给正在跑的子代理发新指令

# 给 1 号子代理发消息/subagents send 1 "优先查 2026 年 5 月的数据"# 指导子代理调整方向/subagents steer 1 "不要太关注技术细节,多写应用场景"

4.3 kill:不干了,关掉子代理

# 停止某个子代理/subagents kill 1# 停止所有子代理/subagents kill all# 停止最近的子代理(# 语法)/subagents kill #1

4.4 快速管理表

别纠结,看这张表就够了:

命令
功能
示例
/subagents list
查看所有子代理
/subagents info 1
查看 1 号状态
看进度、用时
/subagents log 1
查看 1 号日志
看它干了什么
/subagents log 1 50 tools
含工具调用的日志
看用了哪些工具
/subagents send 1 "消息"
发消息给 1 号
提供额外信息
/subagents steer 1 "消息"
指导 1 号调整方向
改变工作重点
/subagents kill 1
停止 1 号
不需要了
/subagents kill all
停止所有
紧急清理

5. 子代理的”记忆”和权限

5.1 子代理能看到什么文件?

这是很多人关心的问题——子代理不是完全克隆你的 AI,它有自己的一套文件:

文件
主 AI 能看到
子代理能看到
说明
AGENTS.md
行为守则(共享)
TOOLS.md
工具笔记(共享)
SOUL.md
人格(子代理不需要)
IDENTITY.md
身份(子代理不需要)
USER.md
你的信息(子代理不需要)
HEARTBEAT.md
心跳任务(子代理不需要)

关键理解:子代理 = 专注干活的”工人”,不需要知道你的个人偏好和 AI 的人格设定。

5.2 子代理有哪些工具?

默认情况下,子代理获得除了会话工具外的所有工具

可用工具
说明
readwriteedit
文件操作 ✅
execprocess
执行命令 ✅
web_searchweb_fetch
搜索网页 ✅
browser
浏览器控制 ✅
memory_searchmemory_get
记忆搜索 ✅
各种技能工具
天气、股票等 ✅
不可用工具
说明
sessions_list
查看会话列表 ❌
sessions_history
查看会话历史 ❌
sessions_send
给其他会话发消息 ❌
sessions_spawn
生成子代理 ❌

5.3 如何控制子代理的工具权限?

{  "tools": {    "subagents": {      "tools": {        // 禁止子代理使用某些工具        "deny": ["gateway", "cron"],        // 如果设置了 allow,则变为"只允许这些"        // "allow": ["read", "exec", "process"]      }    }  }}
💡 安全建议:如果子代理只是做研究工作,建议禁止 gateway 和 cron 工具。

6. 实战演示

理论看完了,来看看子代理在真实场景中怎么用。以下是三个最常见的用法——

6.1 场景一:同时查三个话题是什么体验?

比如你周末想快速了解三个技术方向,一个个搜太慢了——直接丢给 AI:

“帮我同时研究三个话题: 1. OpenClaw 最新功能有哪些? 2. 2026 年 AI Agent 领域有什么新趋势? 3. Python 3.14 有什么新特性?”

背后发生了什么?

AI 会启动 3 个子代理并行运行,每个子代理的完整流程如下:

子代理 1:研究 OpenClaw 最新功能  → 工具调用:web_search("OpenClaw new features 2026")  → 工具调用:web_fetch("https://docs.openclaw.ai")  → 工具调用:web_search("OpenClaw changelog")  → 整理 15 篇文章,提炼 8 个新功能  → ✅ 完成,推送结果子代理 2:研究 AI Agent 趋势  → 工具调用:web_search("AI Agent trends 2026")  → 工具调用:web_search("Multi-Agent systems latest")  → 工具调用:web_fetch("https://arxiv.org/...")  → 整理 20+ 篇文章,总结 5 大趋势  → ✅ 完成,推送结果子代理 3:研究 Python 3.14 新特性  → 工具调用:web_search("Python 3.14 new features")  → 工具调用:web_fetch("https://docs.python.org/3.14/whatsnew")  → 整理官方文档,列出 10 个重要变更  → ✅ 完成,推送结果

你看到的体验:

⏱️ 00:00 — 你说完需求⏱️ 00:05 — 提示:"启动了 3 个子代理并行处理中..."⏱️ 02:30 — 子代理 3 先完成 → 推送 Python 3.14 研究报告⏱️ 03:45 — 子代理 1 完成 → 推送 OpenClaw 新功能报告⏱️ 05:10 — 子代理 2 完成 → 推送 AI Agent 趋势报告✅ 3 份报告全部到位,总计耗时约 5 分钟

如果不用子代理,串行执行需要 15 分钟——3 个分身同时跑,节省了 2/3 的时间。

💡 对比一下:串行 = 一个人干 3 份活(15 分钟);并行 = 3 个人各干一份(5 分钟)。

6.2 场景二:批量处理数据,分身同时跑

“帮我分析一下这 5 只股票的技术指标:茅台、平安银行、腾讯、阿里、苹果”

AI 可以启动 5 个子代理同时分析,比串行快 5 倍。

6.3 场景三:耗时任务丢后台,你继续聊天

“帮我研究最近 30 天的 AI 热点新闻,综合微博、知乎、Reddit、X 上的讨论”

这种任务可能耗时几分钟到十几分钟——完美适合子代理。你启动后可以继续干别的事,结果会自动推送给你。


7. 成本优化

7.1 为什么要关心成本?

分身多干活爽是爽,但每个分身都要花钱——这是不得不面对的现实。

每个子代理都有自己的上下文和 token 消耗

主 AI 用了一次 → 消耗 1 份 tokens子代理 1 用了一次 → 再消耗 1 份 tokens子代理 2 用了一次 → 再消耗 1 份 tokens

同时开 3 个子代理 = 3 倍的 token 消耗。

7.2 省钱技巧:怎么用最便宜的模型跑子代理

技巧
做法
节省效果
用便宜模型
子代理用 qwen-turbo,主 AI 用 qwen-plus
⭐⭐⭐⭐⭐
限制思考级别
简单任务不需要高思考级别
⭐⭐⭐
控制并发数
不要同时开太多
⭐⭐⭐
用完即删
cleanup: "delete"
⭐⭐

7.3 配置子代理默认模型

{  "agents": {    "defaults": {      "subagents": {        "model": "qwen-turbo",      // 子代理用便宜模型        "thinking": "low",           // 低思考级别        "maxConcurrent": 4,          // 最多同时 4 个        "archiveAfterMinutes": 30    // 30 分钟后自动清理      }    }  }}
💡 推荐配置:主 AI 用高质量模型,子代理用便宜模型 + 低思考级别。

省钱配置掌握了,再来看看能调哪些高级参数——


8. 进阶配置

8.1 并发控制:同时开几个合适?

默认最多同时运行 8 个子代理。但你不一定需要这么多。

💡 什么时候需要改? – 想省钱 → 调小(2-4 个),减少同时运行的 token 消耗 – 批量处理大量任务 → 调大(最多 8 个),加快处理速度 – 日常使用 → 保持默认就行
{  "agents": {    "defaults": {      "subagents": {        "maxConcurrent": 4  // 改成 4 个,省钱      }    }  }}
💡 效果对比maxConcurrent: 4 vs 8 – 同时开 4 个:每个任务独占更多资源,响应更快,token 消耗更少 – 同时开 8 个:处理速度更快,但 token 消耗翻倍,可能出现资源竞争

8.2 超时控制:别让子代理跑太久

💡 什么时候需要改? – 子代理跑飞了(陷入死循环或搜个不停)→ 设超时让它自动停止 – 简单任务(查数据、读文件)→ 设短一点(60-120 秒) – 复杂任务(研究课题、批量处理)→ 设长一点(300-600 秒)

方法一:在配置文件中设置全局默认超时

{  "agents": {    "defaults": {      "subagents": {        "runTimeoutSeconds": 300  // 默认超时 5 分钟,0 表示不限制      }    }  }}

方法二:直接跟 AI 说

“以后启动子代理都设 5 分钟超时,别让它跑太久”

AI 会在内部调用时自动加上超时参数。

💡 超时后会发生什么? 子代理被强制停止,已完成的工不会丢失,但当前正在做的部分会中断。建议复杂任务设长一点,避免中途被打断。

8.3 自动归档:跑完的子代理自动清理

💡 什么时候需要改? – 子代理很多,列表太乱 → 调小(15-30 分钟),快速清理 – 需要反复查看子代理结果 → 调大(60-120 分钟),多留一会儿

子代理完成后,会话会自动归档:

{  "agents": {    "defaults": {      "subagents": {        "archiveAfterMinutes": 60  // 默认 60 分钟      }    }  }}

归档 ≠ 删除。 归档后转录文件会被重命名保留在磁盘上,但会话不再出现在 /subagents list 列表中。如果你需要回头看某个子代理的详细记录,可以在磁盘文件里找到。

不想等自动归档?也可以手动清理——

8.4 立即清理:手动删掉不需要的

💡 什么时候用? – 一次性任务(”帮我查个东西”)→ 用完就删,不占空间 – 敏感任务(涉及密码、密钥)→ 立即清理,不留痕迹

你不能直接调用清理函数,但可以用两种方式实现:

方式一:直接跟 AI 说

“帮我研究一下 XXX,干完就清理掉,别留着”

AI 会在内部调用时自动加上 cleanup: "delete" 参数。

方式二:修改配置文件设置默认行为

{  "agents": {    "defaults": {      "subagents": {        "archiveAfterMinutes": 5  // 5 分钟后自动清理,改小一点      }    }  }}
💡 对比一下: – archiveAfterMinutes: 60 → 子代理结果保留 1 小时,方便回头看 – 让 AI 加 cleanup: "delete" → 完成后立即清理,不留痕迹

9. 常见问题

9.1 子代理和定时任务有什么区别?

别纠结,看这张表:

对比
子代理
定时任务 (Cron)
触发方式
你手动启动
到时间自动触发
执行时机
现在就要干
到点再干
适合场景
并行处理多个任务
定期重复的任务
典型例子
“同时帮我做这 3 件事”
“每天早上 8 点推天气”

简单说:子代理 = “现在立刻同时干”,定时任务 = “到点自动干”。

9.2 子代理能生成子代理吗?

不能。 OpenClaw 明确禁止子代理再生子代理,防止无限套娃导致资源耗尽。

9.3 子代理完成后我怎么看详细记录?

# 查看子代理的完整历史记录(聊天框中输入)/subagents log <id># 通过 session history 查看(API/脚本中使用)sessions_history --sessionKey <childSessionKey>

9.4 Gateway 重启后子代理会怎样?

如果 Gateway 重启:

  • 正在运行的子代理 → 会丢失(尽力而为机制)
  • 已完成但未推送的结果 → 会丢失
  • 已归档的转录文件 → 保留在磁盘上
💡 建议:重要任务不要完全依赖子代理的自动推送,关键结果让 AI 手动汇总。

9.5 子代理能用我的飞书/Telegram 发消息吗?

默认情况下不能——子代理没有会话工具(sessions_sendsessions_list 等)。

这是安全设计——防止子代理意外给其他人发消息。

单点功能讲完了。最后,把定时任务 + 子代理组合起来,看一个真正的自动化工作流——


10. 完整工作流示例

10.1 实战:每天早上自动给你出行业报告

结合定时任务 + 子代理,可以这样玩:

每天早上 8 点(Cron 触发)    ↓主 AI 启动 3 个子代理:    ├── 子代理 1:搜最近 24 小时的 AI 行业新闻    ├── 子代理 2:查主要科技股的涨跌    └── 子代理 3:整理昨天的项目进展    ↓三个同时运行(约 5 分钟)    ↓结果自动推送回来    ↓主 AI 汇总成一份早报,推送给你

这个工作流 = 第 11 篇(定时任务)+ 第 12 篇(子代理) 的完美组合!

想直接抄作业?下面是完整配置——

10.2 完整配置示例(抄作业区)

整个工作流拆成两步:

第一步:Cron 定时任务,每天早上 8 点触发

{  "schedule": {    "kind": "cron",    "expr": "0 8 * * *",    // 每天早上 8:00    "tz": "Asia/Shanghai"    // 北京时间  },  "payload": {    "kind": "agentTurn",    "message": "每天早上行业报告:请启动 3 个子代理分别研究(1)最近 24 小时 AI 行业新闻(2)主要科技股涨跌(3)昨日项目进展,然后汇总成一份早报推送给我"  }}

第二步:主 AI 收到触发后,自动启动 3 个子代理

这一步你不需要做任何事——主 AI 收到 Cron 消息后,会在内部自动调用子代理工具,同时启动 3 个分身:

主 AI 内部操作(自动完成):  → 启动子代理 1:"搜索最近 24 小时 AI 行业新闻,整理 Top 10"  → 启动子代理 2:"查询 AAPL、GOOGL、MSFT、NVDA、META 股价和涨跌"  → 启动子代理 3:"整理 /memory/ 目录下昨天的项目笔记"  → 三个子代理同时运行  → 全部完成后,主 AI 汇总成一份早报  → 通过你配置的通道(飞书/Telegram/微信)推送给你

实际效果:

⏰ 每天早上 8:00  ↓ 自动触发,你不需要做任何事⏰ 8:00 ~ 8:05  ↓ 3 个子代理并行运行⏰ 8:05  ↓ 早报推送到你的手机📱 "【行业早报】2026-06-11   🔥 AI 行业:OpenAI 发布 GPT-5...   📈 科技股:AAPL +2.3%, NVDA +5.1%...   📝 项目:循基系统完成了子代理模块..."

单个技能讲完了,最后总结一下这篇的核心——


11. 总结

搞了 12 篇教程,我们终于让 AI 学会了”分身术”。

回顾一下:

篇目
解锁的技能
第 1 篇
从零部署 OpenClaw
第 2-5 篇
安全配置(认知 → 入口 → 执行 → 进阶)
第 6-7 篇
通信通道配置(Telegram/飞书/QQ Bot)
第 8 篇
大脑文件(人格 + 记忆)
第 9 篇
技能系统(让 AI 学会干活)
第 10 篇
浏览器控制(让 AI 能操作网页)
第 11 篇
定时任务 Cron(让 AI 到点自动干活)
第 12 篇(今天)
子代理(让 AI 能并行分身干活)

💡 一句话总结:子代理 = AI 分身,同时干多件事

子代理 = AI 的分身术 = 从”一个人干所有事”变成”团队指挥官”

🚀 下一篇:给 AI 配多个人格

AI 现在能自己分身干活了。但如果想让 AI 同时服务多个人——你自己、家人、甚至公开服务——就需要多 Agent 配置

💡 下一篇预告:《设备配对全解》——手机连 AI:拍照、定位、屏幕控制,移动端体验!

_👋 我是路人甲甲,公众号「AI 打怪升级」,专注 AI 工具实战。_

_觉得有用?点个在看,分享给需要的朋友。_