Memory 记忆层是 OpenClaw 四层架构的数据底座，全本地文件持久化、分层模拟人类记忆、透明可编辑、语义检索，解决普通大模型 “会话结束就失忆、数据强制上传云端” 的核心痛点。
整体定位：四层架构最底层数据仓库，承接 Agent 读写请求，存储所有对话、偏好、任务记录、业务知识，是实现 AI 长期协作、私有化离线办公的核心支撑。
一、核心设计理念：文件驱动、分层仿生记忆
1. 底层核心思想：文件即记忆
OpenClaw 拒绝黑盒数据库封装，全部记忆以明文 Markdown 文件存储在本机~/.openclaw/workspace/目录，无加密、可直接手动编辑、删除、归档，所有记忆对用户完全透明。
配套 SQLite 向量索引库：纯文本文件供人阅读，向量数据库供机器快速语义检索，两者自动同步修改，兼顾可读性与检索速度。
2. 三层仿生记忆模型（核心分层）
模仿人类记忆「瞬时记忆→短期日常记忆→长期永久记忆」逻辑，三层隔离、分工明确，不会混淆临时琐事与长期核心规则：
运行时瞬时记忆（会话内存，易失）
中期每日日志记忆（Daily Log，时效素材库）
长期常青记忆（MEMORY.md，永久核心知识库）
额外配套辅助记忆文件：人格记忆SOUL.md、梦境复盘DREAMS.md、完整会话存档sessions/。
二、三层记忆详细拆解（存储位置、生命周期、加载规则）
第一层：运行时瞬时记忆（Session 上下文）
存储位置
内存 RAM，不写入磁盘；完整原始对话日志同步落盘至sessions/会话ID.jsonl存档文件。
生命周期
仅存活于单次对话会话，关闭页面 / 重启网关后内存内容清空。
核心作用
保存当前一轮完整聊天上下文，保证对话连贯；
临时缓存技能执行结果、临时变量、工具返回数据；
内置自动上下文压缩机制：对话 token 接近模型窗口上限时，自动总结早期对话，避免溢出，完整原始对话永久存入sessions存档目录备查。
加载规则
每一条用户消息下发时自动加载，会话销毁后内存释放。
第二层：中期每日日志记忆（Daily Logs，草稿素材库）
存储路径
workspace/memory/YYYY-MM-DD.md，按自然日自动生成单文件，一天一份日志文件（记忆概览 - OpenClaw）

生命周期

永久保存在本地磁盘，但检索自带遗忘曲线权重衰减：采用心理学遗忘算法，记忆权重随时间指数衰减，30 天后相关性减半，60 天只剩 1/4 权重；仅作素材参考，不会强制注入每轮对话。

存储内容（自动写入，无需手动操作）

• 当日全部自动化任务执行记录、文件操作、表格处理日志；
• 临时待办、阶段性项目进展、当日会议摘要、临时用户偏好；
• Agent 技能调用完整流程、报错复盘、工具返回原始数据；

加载 & 检索规则

1. 新建会话时自动加载今日 + 昨日两份日志，保证近期任务连贯；
2. 久远历史日志不会自动注入提示词，仅在 Agent 调用memory_search语义检索工具时，按需模糊调取；
3. 属于 “素材草稿区”，仅临时记录，不会永久固化 AI 认知，重要规则需手动沉淀至长期记忆。

第三层：长期常青记忆（MEMORY.md，永久知识库）

存储路径

workspace/MEMORY.md（Agent 工作区根目录，全局唯一长期记忆文件）（内存概述 - OpenClaw (Clawdbot) 文档）

生命周期
永久本地持久化，不受时间衰减规则影响，所有内容为常青知识，每次对话强制加载进模型上下文。
存储内容（稳定、长期、高频复用信息）
用户固定偏好：文件存储路径、表格格式、周报模板、代码规范、称呼习惯；
固定业务规则：办公自动化流程、项目约束、禁止操作、重复执行脚本；
关键历史决策：过往项目方案、踩坑记录、不能重复犯的错误；
私有业务知识：行业术语、客户信息、内部流程、离线文档摘要。
加载规则
每一次对话会话启动，强制完整读取注入系统提示词，AI 天生记住你的长期习惯，不会随时间遗忘；可手动打开文件增删内容，修改后网关自动热更新，无需重启服务。
三、配套辅助记忆文件（扩展记忆体系）
SOUL.md 人格记忆
独立于 MEMORY.md，定义 Agent 性格、说话语气、行为底线、做事风格，属于底层人格记忆，每次推理优先加载，决定 AI 的行为逻辑。
DREAMS.md 梦境复盘记忆（实验性功能）
后台定时自动扫描每日日志，提炼重复工作模式、高频需求、优化方案，写入复盘文档，辅助 AI 自我进化，自动优化自动化流程。
sessions/*.jsonl 完整会话存档
保存所有渠道（Web / 微信 / Telegram）原始对话全量记录，用于审计、回溯、批量导入记忆，不可直接注入上下文，仅作归档备查。
四、记忆层三大核心内置能力
1. 语义向量检索系统（核心工具：memory_search）
Agent 内置专属记忆检索工具，无需人工筛选，AI 可自主检索历史记忆：
流程：用户指令→向量化生成语义向量→同时执行向量相似度检索 + 关键词 BM25 检索→融合打分→返回最相关历史记忆片段；
支持模糊语义匹配，不用精准关键词，例如搜索 “报表”，自动匹配所有 Excel 汇总、周报相关历史任务；
异步执行，检索不阻塞主对话流程，本地离线 Ollama 环境下完全断网可用，向量索引存在本机 SQLite 数据库，不上传云端。
2. 自动记忆写入 / 沉淀机制
自动写入每日日志触发条件
完成一次技能自动化任务（文件处理、表格、网页抓取）；
用户明确指令 “记住 XX 信息”；
会话上下文达到 token 压缩阈值，自动归档本轮对话摘要；
定时 Cron / 心跳任务执行完成，写入任务报告。
长期记忆沉淀两种方式
手动写入：直接编辑 MEMORY.md 文件，或对话发送 “把 XX 永久记到我的长期知识库”；
自动复盘沉淀：后台梦境机制定期扫描每日日志，识别高频、长期复用规则，询问用户是否同步至 MEMORY.md。
3. 全链路本地隐私安全机制（本地优先核心体现）
数据零上传：所有 Markdown 记忆文件、向量索引、会话存档全部保存在本机，搭配 Ollama 离线模型可完全断网运行，无任何对话 / 操作数据流出电脑；
分层权限隔离：多 Agent 场景下每个智能体拥有独立工作区，记忆文件互相隔离，办公 Agent、运维 Agent 记忆互不读取；
完整审计日志：所有记忆新增、修改、删除操作全部记录全局日志，可通过openclaw logs回溯谁、何时修改记忆；
最小文件权限：Memory 模块仅拥有自身工作目录读写权限，禁止全盘读写、删除系统文件。
五、Memory 层与四层架构完整交互流程（一次任务全链路）
以指令「每周五自动汇总销售表格生成周报」举例：
1.Gateway 网关：接收 Web / 微信指令，创建独立会话，转发至 Agent；
2.Agent 智能体层（第一步读取记忆）
·自动加载 SOUL.md 人格 + MEMORY.md 长期记忆；
·读取今日、昨日每日日志；
·调用memory_search检索 “销售表格、周报、汇总” 相关历史任务；
·结合所有记忆拆解任务：读取 Excel→数据汇总→生成 Markdown→保存桌面→定时每周五执行；
3.Agent 下发指令至 Skills 技能层
执行文件读取、表格处理、定时任务配置，所有操作结果实时写入当日 Daily 日志；
4.Memory 记忆层写入闭环
（1）本次完整任务流程、表格路径、周报模板自动追加到2026-07-11.md每日日志；
（2）向量索引自动更新，下次查询 “销售周报” 可快速检索本次流程；
（3）若用户说 “以后每周都按这个模板做周报”，Agent 将该规则写入 MEMORY.md 长期记忆永久保存；
5.结果原路返回 Gateway，展示给用户。
六、记忆层核心操作命令（实操管理）

# 1. 查看记忆存储根目录路径
openclaw config get agents.defaults.workspace

# 2. 手动触发记忆向量索引重建（修改大量记忆文件后使用）
openclaw memory reindex

# 3. 清空当日每日日志（仅清空时效素材，不删除长期MEMORY.md）
openclaw memory clear-daily

# 4. 记忆系统自检，修复索引损坏、文件权限问题
openclaw doctor memory

# 5. 检索记忆（命令行手动语义搜索）
openclaw memory search "销售表格汇总周报"

# 6. 重启记忆监控热加载服务
openclaw gateway restart

七、Memory 记忆层五大核心优势

1. 完全透明可控，告别 AI 黑盒记忆

市面上绝大多数 AI 工具记忆加密存储在厂商服务器，用户无法查看、删除；OpenClaw 全部记忆为本地明文 Markdown，可自由编辑、备份、删除、Git 版本管理，完全掌控 AI 认知。

2. 分层仿生记忆，区分临时琐事与长期规则

解决普通 Agent 通病：所有记忆混为一谈，久远无效信息占用上下文、干扰 AI 判断；通过 “时效衰减每日日志 + 无衰减长期知识库” 分离，兼顾短期连贯与长期稳定。

3. 原生支持离线私有化部署，涉密场景友好

搭配 Ollama 本地模型，记忆层四层全本地运行，断网环境完整保存合同、财务、内部项目资料，不存在企业数据上传第三方云端泄露风险。

4. 语义检索自主调用，AI 主动调取历史经验

普通自动化工具无记忆检索能力，每次任务从零开始；OpenClaw Agent 可自主搜索过往任务流程，复用你习惯的模板、路径、格式，越用越贴合个人工作流。

5. 低硬件开销，轻量化运行

记忆文件为纯文本，向量索引占用内存极低，4GB 内存家用电脑即可流畅读写、检索，无需高性能显卡 / 服务器。

八、新手常见记忆 “失忆” 问题避坑

1. 场景：昨天教 AI 的规则今天忘记 原因：仅写入每日日志（时效记忆），未沉淀到 MEMORY.md 长期记忆； 解决：对话发送指令 “把这条规则永久存入长期记忆”，或手动复制内容到 MEMORY.md。
2. 场景：修改 MEMORY.md 后 AI 无变化 解决：文件监控存在 1.5 秒防抖延迟，等待几秒或执行openclaw memory reindex重建索引。
3. 场景：离线 Ollama 模式下记忆检索失效 原因：未开启本地向量嵌入；在 config 中开启本地 embedding 模型，禁用云端嵌入接口。
4. 场景：每日日志文件体积过大、加载缓慢 解决：执行openclaw memory clear-daily清理过期日志，系统会自动总结关键内容沉淀至长期记忆。