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/月度归档

- 工作邮箱：office@shturl.

# 二、周报自动化固定流程

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配置记忆插件。