OpenClaw 仿生三层主记忆分层完整详解
OpenClaw 核心记忆体系模仿人类大脑记忆规律临时工作记忆瞬时思考→短期日常记忆日记素材→长期永久记忆人生经验三层严格隔离、各司其职、存在自动流转晋升链路解决普通 AI 单层记忆混杂、跨会话失忆、记忆黑盒、上下文溢出四大痛点。三层主记忆分别为L1 运行时瞬时记忆、L2 中期每日时效日志记忆、L3 长期常青 MEMORY.md 记忆。一、底层统一设计准则三层共用核心逻辑文件即记忆三层所有可读记忆均为本地明文 Markdown向量库仅作检索加速索引损坏不会丢失原始记忆文本用户可直接编辑、备份、删除无加密黑盒。时间 重要性双重分层按存活周期划分层级越重要、复用频率越高的内容存放层级越持久临时琐事仅存短期层级避免占用模型上下文 Token。记忆自动流转流水线L1 瞬时会话执行完成 → 自动写入 L2 每日日志 → 后台梦境 DREAMS 机制筛选高频重复流程 → 用户确认后固化晋升至 L3 长期记忆形成完整沉淀闭环CSDN博...。全本地离线可用三层记忆全部保存在本机~/.openclaw/workspace搭配 Ollama 本地模型可全程断网运行无任何对话、文件数据上传云端。二、L1 运行时瞬时记忆会话工作记忆・人类 “瞬时思考”1. 核心定位单次对话专属临时工作台等同于大脑当下思考的短期缓存仅服务当前一轮聊天会话结束直接清空不参与跨会话推理。2. 存储介质主存储电脑 RAM 内存易失存储断电 / 重启 / 关闭页面立刻全部清除异步磁盘备份完整对话原始记录写入sessions/会话ID.jsonl归档文件仅用于审计回溯不会自动加载进新会话仅作历史备份。3. 完整生命周期4 种销毁场景主动重置聊天发送清空本次会话临时记忆或执行 CLI 命令openclaw memory clear assistant --conversation current会话新建Web 面板点击新建对话旧会话内存直接释放清零空闲超时默认 2 小时无消息自动销毁瞬时内存可在配置修改超时时间服务 / 设备重启openclaw gateway restart、关机、关闭浏览器内存全部丢失。4. 存储的 4 类核心内容仅单次对话有效完整多轮对话上下文用户提问、AI 回复完整聊天记录保障连续对话不用重复描述需求Skill 技能临时运行缓存网页抓取报文、Excel 表格解析中间数据、脚本运行输出、批量文件临时路径会话元数据SessionID、实时 Token 计数、会话隔离权限、上下文压缩阈值标记单次任务临时变量循环计算中间值、临时文件缓存、一次性查询参数。5. 独有核心能力自动分层上下文压缩解决模型窗口溢出当瞬时内存 Token 占用达到模型上下文窗口 85% 阈值自动触发压缩兼顾信息完整与 Token 占用双保护区不压缩最近 3-5 轮完整对话、所有工具调用配对记录指令 返回结果完整保留不会丢失当前任务细节远期对话摘要精简更早的历史对话调用 LLM 生成精简摘要替换数十轮原始聊天大幅释放上下文空间原始记录永久归档被压缩的完整原始对话异步存入sessions/存档文件随时可回溯完整历史手动触发压缩指令聊天框输入/compact一键释放 Token 空间。6. 加载规则仅当前会话生效新建对话会初始化全新空白瞬时内存完全不会继承上一轮对话的临时数据。三、L2 中期时效日志记忆Daily Log・人类 “每日日记本”1. 核心定位当日工作素材仓库自动记录全天所有自动化操作带心理学遗忘曲线权重衰减区分临时琐事与永久规则兼顾近 48 小时工作连续性又不会让老旧历史干扰新任务推理。2. 存储介质与目录本地明文 Markdown 文件按自然日自动拆分独立文件workspace/memory/YYYY-MM-DD.md一天生成一份日志追加写入模式不会覆盖历史内容openclawap...。3. 生命周期与遗忘机制文件永久保存在本地磁盘不会自动删除内置权重衰减规则记忆相关性随时间指数下降30 天后检索权重减半60 天仅剩 1/4 匹配权重不会自动注入新会话仅 AI 主动调用memory_search语义检索工具时才会按需调取久远日志内容。4. 自动写入触发条件无需手动记录完成任意自动化操作都会自动追加当日日志文件、Excel、PDF 批量处理、归档、重命名网页资讯抓取、接口数据查询、邮件收发Cron 定时任务、心跳巡检执行记录L1 瞬时记忆触发上下文压缩本轮对话摘要同步写入当日日志任务报错、执行复盘、临时待办事项。5. 存储内容范围当日全部技能执行流程、临时项目进度、会议摘要、客户临时需求、文件操作路径、任务踩坑记录、一次性工作流程。6. 自动加载规则三层独有特性每次新建会话系统自动加载今日 昨日两份日志保障近 48 小时工作连贯超过 2 天的历史日志不会自动载入上下文仅在 AI 检索时按需调取避免无用信息堆砌 Token。7. 手动管理方式直接打开对应日期 md 文件手动增删当日工作记录清空当日日志不删除长期记忆openclaw memory clear-daily批量提炼当日高频流程晋升至 L3 长期记忆openclaw memory promote --apply。四、L3 长期常青记忆MEMORY.md・人类 “永久经验知识库”1. 核心定位全局永久核心规则库存放经过筛选、长期高频复用的固定规范无任何时间遗忘衰减是 AI 永久记住用户习惯、标准化流程的核心载体也是三层记忆中优先级最高的持久层。2. 存储介质与路径全局唯一 Markdown 文件固定路径workspace/MEMORY.md全 Agent 会话共享一份长期记忆文件。3. 生命周期永久本地持久化存储不受时间、会话、重启影响写入内容永久生效无权重衰减不会自动失效、自动清除。4. 仅存放三类高价值信息不适合临时琐事用户固定偏好常用工作目录、周报模板、表格格式、文件命名规范、邮箱抄送规则标准化固定业务流程每周定时自动抓取资讯、月度数据汇总、自动归档全流程约束规范与避坑经验禁止全盘删除文件、不读取 C 盘临时缓存、报表统一格式要求、项目固定约束。5. 强制加载规则三层最关键区分点每一次新建会话系统强制完整读取 MEMORY.md 全部内容注入系统提示词AI 执行任何任务前都会读取长期规则跨会话永久生效无需用户重复告知需求。6. 两种写入记忆方式零代码 / 精准编辑双兼容方式 1聊天窗口自然语言写入新手零代码直接下发指令自动追加至 MEMORY.md示例记住我所有周报统一保存到 D:/work/ 月度归档每周五 17 点自动生成并抄送工作邮箱这条规则永久生效。方式 2手动结构化编辑办公 / 开发精准管控直接打开 MEMORY.md用 Markdown 分级标题分类管理大幅提升语义检索匹配精度模板示例# 一、基础办公偏好- 常用工作目录/mnt/d/work/月度归档- 工作邮箱officeshturl.# 二、周报自动化固定流程1. 每周五17点抓取行业资讯2. 生成Markdown周报保存至月度归档3. 自动抄送部门全员邮箱# 三、表格处理强制规范1. Excel汇总后表头加粗、添加黑色边框2. 生成后自动备份副本禁止覆盖原文件修改后文件自带热监控2 秒自动热加载修改大量内容执行openclaw memory reindex重建向量索引。7. 记忆全局管理命令# 一键清空全部长期记忆不可逆谨慎执行 openclaw memory clear # 重建长期记忆向量检索索引 openclaw memory reindex # 语义检索长期记忆内容 openclaw memory search 周报归档规则五、三层主记忆核心维度对比总表六、三层记忆完整流转实战流程办公自动化示例用户指令每周五自动抓取行业资讯生成 Markdown 周报保存桌面并抄送工作邮箱L1 瞬时记忆阶段Gateway 分配独立会话开辟空白内存瞬时记忆写入用户指令Agent 拆解任务调用网页抓取、文件写入、邮件技能抓取资讯、表格解析等临时数据全部存入内存。自动写入 L2 每日时效日志整套周报执行流程、文件路径、邮箱信息自动追加至当日2026-07-18.md日志完整对话备份至sessions/会话ID.jsonl归档。用户指令晋升至 L3 长期记忆发送指令「把这套周报流程永久存入长期记忆」系统自动将完整规则追加写入MEMORY.md永久知识库。次日新会话复用长期记忆新建对话瞬时内存全部清空但会话启动强制加载 MEMORY.md 周报规则直接发送「生成本周周报」即可自动执行全套流程无需重复描述需求同时自动读取昨日日志复用历史文件路径模板。后台梦境自动沉淀DREAMS 后台定时扫描 L2 每日日志识别周报为高频重复任务写入复盘文档支持一键批量沉淀同类流程至长期记忆。七、三层仿生记忆架构核心独有优势仿生分层解决记忆混杂痛点市面绝大多数 AI 仅单层滑动窗口记忆临时琐事、长期规则全部混杂长对话推理混乱三层分级天然区分临时操作、短期素材、永久规范大幅降低 Token 占用提升 AI 执行精准度。全本地透明可控隐私安全拉满三层记忆全部明文存储本机无云端上传多 Agent 场景办公 / 运维 / 数据记忆文件夹独立隔离财务、涉密办公可完全断网离线运行。半自动记忆进化闭环依托 L2 每日日志 梦境复盘机制自动识别高频工作流程一键批量沉淀至 L3 长期记忆无需用户逐条手动记录规则。无损上下文压缩解决大模型窗口限制L1 瞬时记忆专属分层压缩机制远期内容摘要归档、近期对话完整保留不会像 ChatGPT 单层窗口直接丢弃早期对话丢失关键业务规则。双门槛兼容新手零代码 开发者深度自定义普通办公用户通过自然语言对话即可完成记忆记录技术人员可直接修改底层 Markdown 记忆文件、自定义向量检索逻辑、开发记忆管理自定义技能。八、三层记忆高频使用误区避坑隔天 AI 遗忘工作流程误区流程仅保存在 L1 瞬时记忆 / L2 每日日志未晋升至 L3 长期 MEMORY.md解决发送指令永久记录或执行openclaw memory promote --apply批量沉淀当日高频规则。修改 MEMORY.md 后 AI 无变化解决等待文件热监控 2 秒自动加载或执行openclaw memory reindex重建向量检索索引。久远历史任务检索不到原因L2 每日日志自带权重衰减久远内容匹配度降低或向量索引损坏执行openclaw doctor memory修复记忆索引。Ollama 离线模式记忆检索失效解决配置本地嵌入向量模型关闭云端 Embedding 接口重新执行openclaw onboard配置记忆插件。