一个Openclaw多Agent自动化协作情况下，记忆丢失问题解析

核心概述一个Openclaw多Agent如果想实现各Agent自动化沟通最简单的办法是设置一个主Agent由主Agent使用sessions_spawn派发任务给其他Agent。经过一段时间测试发现这种模式经常出现记忆不同步的问题经过分析发现这个问题的根本原因是sessions_spawn的机制导致的。本文核心思想Workspace 是持久存储的「硬盘」Session 是临时使用的「内存」Memory 是需主动写入的「数据库」。三者的关系是Session 加载时从 Workspace 读取 Memory处理完毕后由 Agent 决定是否写回。因此Memory 不会自动同步需要通过sessions_send同步或手动写入隔离任务来保证一致性。一句话概括多 Agent 协作时记忆同步是最大痛点——目前想到的解决办法要么让主Agent用sessions_send派送任务 要么使用sessions_spawn派送但主Agent收到结果后立刻手动记录结果并同步给其他Agent。目录一、导言二、核心概念三、三者关系详解四、实战操作指南五、问题排查与解决方案六、配置参考七、总结一、导言本文档通过对 OpenClaw 系统中Workspace工作空间、Session会话、Memory记忆三个核心概念的关系与使用规范来说明同一个openclaw下配置多Agent自动化协作容易丢失的问题。前置知识本文假设你已了解 OpenClaw 的基本架构包括 Main Agent、Subagent 等概念。核心知识点sessions_spawn存在一个隔离保护机制该机制的主要目的是为了保护其他Agent当前正在进行的会话以及任务不被主Agnet发送来的新任务影响。我采用的多Agent协作模式由主Agent通过sessions_spawn派发任务。调用时需指定runtime: subagent这会为目的Agent创建隔离的子会话并执行任务该动作避免干扰目的Agent的主会话main session但却是让记忆丢失的元凶。这个子会话中的subAgent完成任务后只把结果返回给主 Agent不会自动写入任何 Memory 文件。目的Agent虽然干了活但是由于其subAgent的子会话没有留下任何记录导致其根本不知道这个任务的细节以及结果长此以往多 Agent 间的记忆会逐渐割裂形成「信息孤岛」。sessions_spawn 信息格式sessions_spawn( agentId:quality,//agent ID runtime:subagent,//运行时类型 task:请审核新文件...,//任务内容 timeoutSeconds:120//超时时间 )二、核心概念2.1 Workspace · 工作空间定义每个 Agent 独立的文件系统存放配置文件、参考文档和知识库。属性说明位置~/.openclaw/workspace-agentName/作用持久存储配置文件、知识库、记忆文件生命周期永久存在目录结构~/.openclaw/├── workspace/# Main Agent├── workspace-architect/# 架构师├── workspace-writer/# 写手└── workspace-Quality/# 质检员Workspace 内部文件文件用途AGENTS.mdAgent 配置SOUL.mdAgent 角色定义USER.md用户信息MEMORY.md长期记忆TOOLS.md工具配置HEARTBEAT.md心跳任务memory/YYYY-MM-DD.md每日记忆2.2 Session · 会话定义每一次对话的独立上下文存储对话历史。属性说明位置~/.openclaw/agents/agentId/sessions/格式JSONL 文件生命周期默认 30 天后清理Session Key 格式类型格式场景主会话agent:agentId:main直接对话私聊agent:agentId:direct:peerId按用户隔离群聊agent:agentId:channel:group:id按群隔离子任务agent:agentId:subagent:uuid派发任务2.3 Memory · 记忆定义持久化的文本记忆供 Agent 加载参考。类型文件位置用途长期记忆MEMORY.md重要决策、偏好、持久知识每日记忆memory/YYYY-MM-DD.md当天工作记录加载规则每次 Session 启动时1.加载 SOUL.md → Agent 角色定义2.加载 USER.md → 用户信息3.加载当日昨日日记 → memory/YYYY-MM-DD.md4.加载 MEMORY.md → 仅限主会话三、三者关系详解3.1 关系图┌─────────────────────────────────────────────────────────┐ │ Workspace (硬盘) │ │ ┌─────────────────────────────────────────────────┐ │ │ │ AGENTS.mdSOUL.mdUSER.mdMEMORY.md│ │ │ │ memory/ │ │ │ │ └──2026-03-20.md│ │ │ └─────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘ ↑ │ 加载 ↓ ┌─────────────────────────────────────────────────────────┐ │ Session (内存) │ │ ┌─────────────────────────────────────────────────┐ │ │ │ agent:main:20260320│ │ │ │ - 对话历史 │ │ │ │ - 上下文 │ │ │ └─────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘3.2 类比理解概念类比说明Workspace硬盘持久存储存放所有文件Session内存临时使用对话结束后清理Memory数据库长期积累可查询3.3 数据流用户发送消息 ↓ 加载 Session 上下文 ↓ 加载 Workspace 中的Memory↓ Agent 处理 ↓ 决定是否写入Memory↓ 返回响应四、实战操作指南4.1 Subagent 任务处理核心原则Subagent 完成任务后不会自动写入 Memory。sessions_spawn vs sessions_send工具Session Key隔离性记忆同步sessions_spawnagent:xxx:subagent:uuid✅ 隔离❌ 不自动同步sessions_sendagent:xxx:main❌ 共用✅ 自动同步使用场景场景推荐工具临时任务需要隔离sessions_spawn重要任务需要同步sessions_send4.2 手动同步记忆流程当使用sessions_spawn派发任务并收到结果后必须手动记录收到 subagent 结果 ↓1. 写入自己的 memory/YYYY-MM-DD.md↓2. 同步到对方的 memory/YYYY-MM-DD.md↓ 完成示例代码// 收到 Quality 审核结果后constresult awaitsessions_spawn({ task:审核第26章});// 手动记录awaitwrite(memory/2026-03-20.md, ### 第26章审核结果- 状态通过 - 问题已修复 );// 同步到 Quality 的记忆awaitsessions_send({ sessionKey:agent:Quality:main, message:已记录审核结果到记忆});4.3 写入决策指南内容写入位置时机临时工作记录memory/YYYY-MM-DD.md收到结果后重要决策MEMORY.md确认后用户偏好MEMORY.md首次得知时任务状态更新memory/YYYY-MM-DD.md每次变化五、问题排查与解决方案5.1 常见问题问题1记忆不同步现象用户直接 Quality 审核 → Quality 写入了 MEMORY.mdMain 派发任务给 Quality → 结果返回 Main但 Main 没记录原因两种方式访问不同的 Sessionsubagent Session 不会自动同步解决方案优先使用sessions_send处理重要任务收到 subagent 结果后立即手动写入问题2Session 无法复用现象每次对话都像全新会话上下文丢失可能原因用户发送了/new或/resetSession 已过期默认 30 天解决方案检查是否有重置命令检查 Session 维护配置5.2 诊断流程发现记忆不一致↓ 检查是否使用了 subagent ↓ ├─ 是 → 确认是否有手动写入 └─ 否 → 检查 Session 加载配置确认问题后 → 应用解决方案六、配置参考6.1 Session 配置{session:{dmScope:main,// 私聊复用主会话reset:{mode:daily,atHour:4// 每天 4 点重置},maintenance:{mode:enforce,pruneAfter:30d,// 30 天后清理maxEntries:500}}}6.2 Memory 配置{agents:{defaults:{memorySearch:{enabled:true,provider:openai,model:text-embedding-3-small}}}}七、总结核心要点概念关键点Workspace每个 Agent 独立的文件夹永久存储Session对话上下文30 天后清理Memory需主动写入不自动同步Subagent临时任务结果需手动记录sessions_spawn隔离执行不影响主会话sessions_send同步执行共用主会话最佳实践重要任务→ 使用sessions_send临时任务→ 使用sessions_spawn 手动记录定期检查→ 核对各 Agent 记忆是否一致经验总结重要任务用 sessions_send临时任务用 sessions_spawn收到结果后立即写入 memory。