搞定了 OpenClaw 的微信接入，让 Agent 有了交互入口，却发现单 Agent 根本撑不起复杂工作？让一个 Agent 既做内容又搞技术还跑运营，就像让一个人同时身兼数职，样样经手却样样不精。

OpenClaw 的核心优势本就是多 Agent 协作，可打开目录一看，workspace、agentDir、sessions、subagents 一堆概念扎堆，长得像 “亲戚” 根本分不清，更别说让它们配合干活。这篇文章就带你从核心概念拆解到实际落地，把 OpenClaw 多 Agent 的运转逻辑讲透，让你从一脸懵到真正把多 Agent 协作跑起来。

 回到正题~

先看全景：多 Agent 体系的 5 个核心概念，类比公司秒懂

OpenClaw 的多 Agent 系统看似复杂，本质就围绕 5 个核心概念展开，把整个体系想象成一家公司，所有概念瞬间清晰：

openclaw.json是公司的 HR 系统，管着所有 Agent 的 “入职信息” 和权限；每个 Agent 有专属的工位（workspace）、员工档案（agentDir）、工作日志（sessions）；上级 Agent 能通过 ** 派工单（subagents）** 给下属安排工作。HR 系统里没登记的 Agent，根本无法参与公司协作。

搞懂这层对应关系，多 Agent 的底层逻辑就掌握了一半，接下来逐个拆解每个概念的核心作用。

第一层：单个 Agent 的「三件套」，决定它是谁、怎么干、怎么记

每个 Agent 在磁盘上都对应三块核心内容，这是它能独立工作的基础，打开～/.openclaw/ 目录就能找到对应的文件结构，三者各司其职、缺一不可。

workspace：Agent 的 “工作工位”，决定它「是谁、怎么干活」

workspace 里存放的全是和 Agent 工作内容相关的核心文件，是定义 Agent 人设和工作能力的关键：SOUL.md 定调 Agent 的身份和工作风格，比如是 SEO 专家就说话专业、贴合行业；TOOLS.md 明确 Agent 能使用的工具，比如网页搜索、文件读写；memory / 文件夹则存储 Agent 的上下文记忆，记录工作过程中的关键信息。

简单说，workspace 决定了 Agent 的思考方式和工作能力。它的默认路径一般是～/.openclaw/workspace 或～/.openclaw/workspace-xxx，也可以自定义放在任意位置，只要在配置文件里写对路径，OpenClaw 就能识别。

agentDir：Agent 的 “员工档案柜”，决定它「怎么登录、怎么运行」

agentDir 里存放的是系统层面的配置信息，比如 Agent 使用的模型、认证方式、实时运行状态等，是 Agent 能接入 OpenClaw 系统的 “门禁卡”。

这个目录不需要频繁手动修改，但必须存在，就像员工不会天天翻自己的档案，但没有档案就无法进入公司。它的默认路径通常是～/.openclaw/agents/[AgentID]/agent，按固定格式创建即可。

sessions：Agent 的 “专属工作日志”，各记各的不混淆

每个 Agent 都有独立的 sessions 目录，用来存储自己的对话记录和工作流程，不同 Agent 的日志完全隔离，不会互相污染。比如主 Agent 和 SEO 专家 Agent 的协作记录，会分别存在各自的 sessions 里，就像公司里每个人有自己的工作周报，不会混在一起写，避免后续工作出现上下文错乱。

第二层：Agent 之间怎么协作？靠 4 个工具，按规则 “派活追进度”

单个 Agent 的工作基础搞清楚后，核心问题就来了：不同 Agent 之间该如何配合完成复杂任务？答案很简单 ——通过工具实现协作，在 OpenClaw 中，Agent 的所有协作行为，都是通过调用专属工具来找人、派活、跟进进度，而工具的使用又受配置规则约束。

先避坑：工具是 “动作”，配置是 “规则”，别搞混

这是新手最容易绕进去的点：比如 sessions_spawn 是协作工具，作用是让 Agent “拨号” 呼叫其他 Agent 配合；而 subagents.allowAgents 是配置规则，决定了当前 Agent 的 “通讯录” 里有哪些可调用的 Agent。工具是 Agent 能执行的动作，配置是动作的执行边界，二者缺一不可。

核心逻辑：按配置 “拨号”，不是扫目录 “找人”

很多人误以为，sessions_spawn 会自动扫描磁盘目录，看到像 Agent 的文件夹就拉过来协作，这是完全错误的。

sessions_spawn 的核心逻辑是 “按配置拨号”：只有在 openclaw.json 中登记过、且在当前 Agent 的 subagents.allowAgents 白名单里的 Agent，才能被成功调用。哪怕磁盘里有再多 Agent 目录，只要配置里没登记，就永远无法被呼叫，这是保证多 Agent 协作有序的关键。

权限控制：先查 “电话簿”，再打 “电话”

Agent 在调用其他伙伴前，会先通过 agents_list 工具查询自己的可调用名单，而这份名单由 subagents.allowAgents 白名单严格控制，实现了不同角色看到不同的协作范围。

比如系统里有 manager、seo-specialist、frontend-developer、copywriter、data-analyst5 个 Agent，但 manager 的配置里，subagents.allowAgents 只写了前 3 个，那 manager 调用 agents_list 时，只能看到这 3 个 Agent，data-analyst 哪怕已登记，也不在其通讯录里，无法被呼叫。这种权限机制能有效避免协作混乱，让不同 Agent 各司其职。

第三层：真正的大脑 ——openclaw.json，管着所有协作规则

前面的 workspace、agentDir、sessions、subagents 所有概念，最终都汇聚到一个核心文件：~/.openclaw/openclaw.json。它是整个多 Agent 系统的组织架构图 + 通讯录 + 权限表，三合一的核心配置中心，OpenClaw 只认这份配置，不认磁盘目录的名字。

在这个文件里，每个 Agent 的核心登记信息必须写清，缺一不可：

• id：Agent 的唯一标识，所有协作调用都靠这个名字；
• workspace：Agent 的工作区路径，定义它的人设和能力；
• agentDir：Agent 的状态目录路径，定义它的运行方式；
• subagents.allowAgents：Agent 的可调用白名单，定义它的协作范围。

第四层：agency-agents 是什么？现成的 “人才市场”，需 “入职” 才能用

很多人看到～/.openclaw/agency-agents/ 目录，会误以为这是 OpenClaw 的内置功能，里面的 Agent 能直接调用，其实不然。

agency-agents 就是一批提前写好的 workspace 模板，把 SEO 专家、前端工程师、文案写手、数据分析师等常见角色的 SOUL.md、TOOLS.md、AGENTS.md 都配置好，打包放在一个目录里方便管理，就像一个 “人才市场”，有各种现成的专业角色。

但人才市场里的 “人”，不会自动变成你的协作伙伴，必须完成三步 “入职手续”，才能正式参与多 Agent 协作：

1. 准备工位：把 agency-agents 里的角色模板，放到指定的 workspace 目录；
2. 建立档案：为该角色创建对应的 agentDir 系统状态目录，存放模型、认证等配置；
3. 登记入册：通过命令行openclaw agents add将 Agent 信息写入openclaw.json，完成注册。
    

当然也有 “偷懒办法”：把 agency-agents 的 GitHub 仓库地址交给 OpenClaw，它会自动完成路径落地、目录创建和配置注册，省去手动操作的麻烦。记住，安装 agency-agents 的本质，从来不是简单复制文件，而是完成 workspace、agentDir、openclaw.json 的三步配置。

第五层：实战落地：什么时候用多 Agent？怎么拆任务才高效？

搞懂所有概念后，最终要落到实际使用，多 Agent 协作不是用得越多越好，而是要在合适的场景用、按正确的原则拆任务，才能发挥最大价值。

这两种场景，一定要上多 Agent

1. 主从协作：一个指挥，多个干活适合完成需要多专业配合的复杂任务，比如 “做一个产品落地页”。主 Agent 先拆解任务，再分别调用对应 Agent 并行工作：SEO 专家分析关键词和标题、前端工程师写页面代码、文案写手撰写产品描述，所有子 Agent 完成工作后，主 Agent 汇总结果，效率远高于单 Agent 单打独斗。

2. 临时外援：主线不停，支线并行适合在核心工作中需要临时补充信息的场景，比如和主 Agent 讨论技术方案时，突然需要一份竞品分析。与其打断当前的主线对话，不如直接调用数据分析师 Agent 完成支线任务，任务结束后主 Agent 将结果拉回主线，既保证主线工作不被污染，又不耽误支线任务推进。

拆任务的黄金原则：按产出物拆，不按动作拆

多 Agent 协作的任务拆解，最关键的一点是让每个子 Agent 对一个明确的产出物负责，而不是把一个动作拆分给多个 Agent。比如做落地页，拆成 “关键词分析报告”“页面代码文件”“产品描述文案” 三个产出物，分别交给三个 Agent，而非把 “写文案” 拆成 “想标题”“写正文” 两个动作。按产出物拆解，能保证每个 Agent 的工作目标清晰，最终汇总的结果质量更高、逻辑更清晰。

新手必避：多 Agent 协作的 3 个大坑

1. 坑一：以为目录存在，Agent 就存在

   OpenClaw 不会自动扫描磁盘目录识别 Agent，只认 openclaw.json 里的配置信息。哪怕磁盘里有上百个 Agent 目录，只要配置里没登记，就无法被调用、参与协作。

2. 坑二：搞混 workspace 和 agentDir

   记住一句口诀就能分清：办公桌上放文件（workspace），档案柜里放工卡（agentDir）。workspace 是 Agent 的工作内容区，管 “干什么、怎么干”；agentDir 是 Agent 的系统配置区，管 “怎么登、怎么跑”，二者功能完全不同，不能混为一谈。

3. 坑三：不设 allowAgents，导致协作权限混乱

   不要让所有 Agent 互相调用，建议按实际协作关系设计白名单：比如 manager 主 Agent 能调用所有子 Agent，而 seo-specialist、copywriter 等子 Agent 之间，默认不互相调用，避免无关 Agent 互相干扰，保证协作流程有序。

    

快速开始：跑通多 Agent 的最小可用路径

如果只想最快把 OpenClaw 多 Agent 协作跑起来，不用一上来就注册十几个 Agent，按这个极简路径操作，先跑通链路再逐步扩展：

1. 先配置 1 个主 Agent + 2 个子 Agent，完成基础的配置注册；
2. 测试主 Agent 对单个子 Agent 的调用，确认消息能正常来回、协作能正常触发；
3. 验证成功后，再逐步添加权限配置、多 Agent 并行调用等复杂功能；
4. 按实际工作需求，慢慢扩展 Agent 数量和协作流程。
    

其实多 Agent 协作的核心意义，从来不是能同时跑多少个 Agent，而是让每个 Agent 在自己擅长的领域全力输出，就像一支真正的团队，各司其职、各展所长，最终完成单 Agent 根本做不到的复杂任务，这也是 OpenClaw 多 Agent 体系的核心价值。

从概念理清到落地跑通，掌握这份指南，你就能真正把 OpenClaw 的多 Agent 协作用起来，让不同的 AI Agent 成为你的专属协作团队，高效搞定各类复杂工作。