OpenClaw Agent 架构设计指南

如何正确划分 Agent 和 Subagent：按业务领域记忆，而非人类岗位职责

💡 核心原则：Agent 应该代表业务领域专家（拥有长期记忆和专业知识），而 Subagent 是该领域内的任务执行者（临时的、共享父级记忆）。

❌ 常见误区：按人类岗位划分 Agent

错误做法：创建 "开发 Agent" + "文案 Agent" + "设计 Agent"

问题所在：

  • 每个 Agent 缺乏完整的业务上下文
  • 需要频繁跨 Agent 协调，效率低下
  • 无法形成深度的专业知识积累
  • 违背了 AI Agent 的本质优势

✅ 正确方法：按业务领域记忆划分 Agent

正确做法：创建 "销售业务 Agent" + "AI产品 Agent" + "个人助理 Agent"

优势：

  • 每个 Agent 拥有完整业务领域的长期记忆
  • 能够积累深度专业知识和经验
  • 形成专业的判断能力和决策逻辑
  • 任务执行时可以动态创建 Subagent

📊 核心架构图

OpenClaw / 顶层主 Agent 战略协调 · 跨业务决策 · 拥有完整个人长期记忆 销售业务 Agent 🎠 完整销售领域长期记忆 🧠 伴生 Memory / Workspace AI产品 Agent 🎠 完整产品领域长期记忆 🧠 伴生 Memory / Workspace 个人助理 Agent 🎠 完整个人生活长期记忆 🧠 伴生 Memory / Workspace 开发 Subagent 临时任务执行 文案 Subagent 临时任务执行 设计 Subagent 临时任务执行 测试 Subagent 临时任务执行 调研 Subagent 临时任务执行 分析 Subagent 临时任务执行 优化 Subagent 临时任务执行 交互 Subagent 临时任务执行 复盘 Subagent 临时任务执行 规划 Subagent 临时任务执行 评审 Subagent 临时任务执行 部署 Subagent 临时任务执行 第一层：核心原生技能 第二层：社区安装技能 第三层：自定义扩展技能

✅ OpenClaw 正确架构：按业务领域记忆划分

个人助理Agent (总经理)
战略协调 · 资源调度 · 跨业务决策
↓
销售业务Agent
商业策略 · 客户洞察 · 销售优化
🧠 持久化记忆
AI产品Agent
技术架构 · 产品设计 · AI能力
🧠 持久化记忆
↓
开发
Subagent
💻 编码技能库
S
文案
Subagent
📝 写作技能库
S
设计
Subagent
🎨 设计技能库
S
测试
Subagent
✅ 测试技能库
S
 
开发
Subagent
💻 AI编码技能库
S
文案
Subagent
📝 技术写作技能库
S
设计
Subagent
🎨 UI/UX技能库
S
分析
Subagent
📊 数据分析技能库
S
💡 说明：S = 可访问共享技能库 (Shared Skills)
🔑 核心原则：
• Agent = 业务领域专家（拥有持久化记忆）
• Subagent = 任务执行者（临时的，共享父级记忆 + 调用专用技能库）
• 按业务领域记忆划分，而不是按人类岗位职责划分
• 每个Subagent可调用不同的Skills库来完成专业任务

📱 移动端说明：此架构图使用响应式设计，在手机上会自动调整布局

核心口诀："Agent记业务，Subagent用技能做任务"

🎯 实际案例演示

场景：智能问数 AI 产品开发

顶层：个人助理 Agent（你）

  • 角色：战略协调、资源调度、跨业务决策
  • 能力：管理其他两个 Agent，处理综合事务

中层：AI产品 Agent

  • 角色：AI产品业务领域的专家
  • 记忆：积累 AI 产品知识、技术栈、用户需求
  • 技能：技术文档写作、产品架构设计、AI 能力评估

底层：Subagent（动态创建）

  • subagent-writer：负责技术白皮书撰写
  • subagent-developer：负责技术细节验证
  • subagent-tester：负责功能测试

⚙️ 技术实现要点

独立 Agent 创建：

  • 在 ~/.openclaw/agents/ 目录下创建独立配置
  • 每个 Agent 有自己的 SOUL.md、MEMORY.md、config.json
  • 通过 sessions_spawn({agentId: "your-agent-id"}) 调用

Subagent 使用：

  • 通过 sessions_spawn({runtime: "subagent"}) 动态创建
  • 自动继承父 Agent 的工作目录和配置
  • 可以指定不同的模型和思考模式

🌟 最佳实践建议

  1. 从 Subagent 开始：先用子智能体测试某个角色是否真的有价值
  2. 升级为独立 Agent：如果某个角色经常被使用，再创建独立的持久化版本
  3. 混合使用策略：简单任务用 Subagent，复杂项目用独立 Agent
  4. 保持记忆隔离：不同业务领域的知识不要混在一起

这个指南帮助你理解 OpenClaw 的核心架构思想。
记住：按记忆划分，而不是按岗位划分。