OpenClaw 三层记忆架构解析:SOUL.md 人格设定 × USER.md 用户画像 × NOTES.md 笔记联动的 4 种协同场景
1. 三层记忆不是“存东西”,而是给AI装上三套独立的决策神经系统大多数人第一次看到 SOUL.md、USER.md、NOTES.md 这三个文件时,下意识反应是:“哦,这是个配置目录,用来存点设定和笔记”。我试过在三个不同团队做内部分享,90% 的开发者听完第一版 OpenClaw 记忆架构介绍后,回去改的都是 NOTES.md——因为“笔记”最像他们熟悉的 README 或 Confluence 页面。结果两周后反馈来了:上下文还是丢,Agent 在跨模块调用时频繁“失忆”,甚至把用户刚提的紧急线上 Bug 当成新需求重写一遍。问题不在工具,而在理解偏差。OpenClaw 的三层记忆根本不是“存储层”,它是一套分权制衡的实时决策调度系统。SOUL.md 不是人格说明书,它是 Agent 的底层运行时策略总线;USER.md 不是用户档案,它是每次请求抵达时自动加载的会话级上下文熔断器;NOTES.md 更不是笔记库,它是被显式触发的外部知识索引代理。三者之间没有主从关系,只有协同契约。这个认知偏差直接导致了你提到的三大坑点:过度依赖(把 NOTES.md 当万能缓存)、代码质量下降(SOUL.md 约束缺失导致生成逻辑失控)、上下文丢失(USER.md 权限粒度太粗,无法隔离多任务会话)。我在金融风控中台项目里踩过最深的一次坑,就是把所有业务规则硬塞进 NOTES.md,结果当风控模型更新和接口文档同步两个任务并行时,Agent 把旧规则和新字段描述混在一起生成了错误的校验逻辑——它不是记错了,是根本没意识到这两个任务该走不同的记忆通道。所以本节不讲“怎么