作用

通过将所有实际工作委派给临时子 agent，保持主对话上下文整洁。

主会话 = 调度器 + 汇报者，不是工作者

触发方式

显式触发

• "委托这个" / "delegate this"
• "使用子 agent" / "use subagent"
• "生成 agent" / "spawn agent"

隐式触发（自动）

• 网络搜索或浏览
• 读取/写入/编辑文件
• 代码执行或分析
• API 调用或外部操作
• 数据处理或转换
• 使用任何工具（bash、web、read、write、edit 等）

核心规则（必须遵循）

规则 1：委派所有需要工具的任务

// 应该做 - 委派给子 agent
sessions_spawn({
  task: "清晰具体的任务描述",
  runtime: "subagent",
  mode: "run",
  cleanup: "delete",  // 关键 - 自动清理记录
  model: "zai/glm-4.7-flash"  // 可选：简单任务使用快速模型
})
// 不要做 - 在主会话直接执行
// 不要直接使用 web_search、browser、read、write、edit、bash 等
// 特别注意：写入 soul.md 也必须委派，绝不能在主会话直接写入

规则 2：只有纯对话留在主会话

以下情况才不委派：

• 纯对话（问候、闲聊）
• 无需工具的简单问答（如"2+2等于几"）
• 确认/澄清事项
• 关于委派本身的元讨论

规则 3：记忆判断（两个检查点）

检查点 1：委派前

// 如果任务重要则存储：决策、偏好、重大项目
if (任务涉及重要决策 || 用户偏好 || 重大项目) {
  memory_store({
    text: "决策/偏好/项目的简要总结",
    category: "decision" | "preference" | "fact",
    importance: 0.7
  })
}

检查点 2：收到结果后

// 如果结果有长期价值则存储：配置、事实、决策
if (结果是重要事实 || 配置 || 决策结果) {
  memory_store({
    text: "简短的1-2句话总结",
    category: "fact" | "decision" | "other",
    importance: 0.6
  })
}
// 不要存储：临时信息（新闻、天气）、一次性查询、聊天内容

规则 4：写入 soul.md

重要：任何写入 soul.md 的操作都必须委派给子 agent

// 正确 - 委派给子 agent
sessions_spawn({
  task: "将以下内容写入 soul.md：[具体内容]",
  runtime: "subagent",
  mode: "run",
  cleanup: "delete"
})
// 错误 - 不要在主会话直接写入
// write({ file_path: "soul.md", content: "..." })

写入场景示例：

• 记录重要对话总结
• 保存用户偏好设置
• 存储项目决策和里程碑
• 记录学习笔记和知识点

规则 5：简洁汇报结果

• 使用要点列表
• 给出结果，不描述过程
• 绝不要向用户提及"子 agent"、"生成"、"委派"、"subagent"、"runtime"
• 用户应该只看到结果

使用示例

示例 1：网络搜索

用户： "查看今天的科技新闻"

// 正确
sessions_spawn({
  task: "搜索今天的主要科技新闻，总结3-5条关键内容并附带简要描述",
  runtime: "subagent",
  mode: "run",
  cleanup: "delete",
  model: "zai/glm-4.7-flash"  // 简单任务，使用快速模型
})
// 错误 - 不要这样做
// web_search({ query: "tech news today" })

给用户的结果（简洁）：

以下是今天的主要科技新闻：
• Apple 发布 iOS 18.2，新增 AI 功能
• OpenAI 宣布 GPT-5 预览版
• Tesla 揭晓新机器人出租车设计
• Chrome 获得重大隐私更新

示例 2：文件分析

用户： "分析这个代码文件"

// 正确
sessions_spawn({
  task: "阅读并分析 /path/to/file.js 的代码，识别主要函数、使用的模式，以及任何潜在问题",
  runtime: "subagent",
  mode: "run",
  cleanup: "delete"
})

示例 3：代码编写

用户： "写一个解析 JSON 的函数"

// 正确
sessions_spawn({
  task: "编写一个带错误处理的 JavaScript JSON 安全解析函数。包含使用示例。",
  runtime: "subagent",
  mode: "run",
  cleanup: "delete"
})

记忆判断示例

委派前存储

// 用户："以后简单搜索用快速模型"
memory_store({
  text: "用户偏好：简单搜索任务使用 glm-4.7-flash",
  category: "preference",
  importance: 0.8
})
// 用户："我要开始一个新项目，构建 Rust 网络服务器"
memory_store({
  text: "用户开始新项目：Rust 网络服务器",
  category: "other",
  importance: 0.7
})

收到结果后存储

// 子 agent 返回："OpenClaw 版本 2026.3.8 支持 skill 热重载"
memory_store({
  text: "OpenClaw 2026.3.8 支持 skill 热重载功能",
  category: "fact",
  importance: 0.7
})

不存储

// 今天的新闻（明天就过时）
// 天气（临时信息）
// "这个文件有多少行"（一次性查询）
// 闲聊内容

决策流程

┌─────────────────────┐
│   用户请求          │
└──────────┬──────────┘
           │
           ▼
    ┌──────────────┐
    │ 需要工具？   │ ← 包括：搜索、读写、执行、API 调用、写入 soul.md
    └──────┬───────┘
           │
    ┌──────┴──────┐
    │             │
   否            是
    │             │
    ▼             ▼
┌─────────┐  ┌─────────────────┐
│ 在主会话│  │ 🧠 记忆检查     │
│ 处理    │  │ （委派前）       │
└─────────┘  └────────┬────────┘
                      │
                      ▼
              ┌──────────────────┐
              │ 生成子 agent     │
              │ cleanup:"delete" │
              └────────┬─────────┘
                       │
                       ▼
              ┌─────────────────┐
              │ 子 agent 执行   │
              └────────┬────────┘
                       │
                       ▼
              ┌───────────────────┐
              │ 🧠 记忆检查       │
              │ （结果后）         │
              └────────┬──────────┘
                       │
                       ▼
              ┌─────────────────┐
              │ 汇报结果       │
              │ （简洁）       │
              └─────────────────┘

配置

在 AGENTS.md 或 USER.md 中启用：

## 任务委派模式
所有需要工具的任务都自动委派给子 agent 处理。
主会话绝不直接使用工具（除了 memory_store）
始终使用 sessions_spawn() 配合 cleanup:"delete"
在两个检查点判断记忆存储
简洁汇报结果，不要提及委派过程
特别注意：写入 soul.md
写入 soul.md 是工具操作，必须委派给子 agent：
绝不在主会话直接使用 write 工具写入 soul.md
任何需要记录到 soul.md 的内容都通过 sessions_spawn 委派

清理机制

cleanup: "delete" 参数确保：

• 子 agent 记录自动标记为待删除
• 系统定期运行清理
• 无需人工干预
• 主会话永久保持精简

为什么这很重要

问题： 长对话会积累大量工具输出到上下文中 解决： 只保留任务摘要，丢弃执行细节 收益： 会话保持快速、低成本、专注于结果