目录摘要1. 引言 - AI 的健忘问题1.1 为什么 AI 需要记忆1.2 OpenClaw 记忆系统架构1.3 记忆类型对比2. MEMORY.md 长期记忆2.1 什么是 MEMORY.md2.2 MEMORY.md 文件结构2.3 MEMORY.md 读写规则读取时机写入时机2.4 实战MEMORY.md 使用示例3. memory/YYYY-MM-DD.md 每日日志3.1 什么是每日日志3.2 每日日志文件结构3.3 日志写入时机3.4 日志维护策略4. memory_search 语义搜索4.1 什么是语义搜索4.2 memory_search 工具详解工具签名返回格式4.3 使用场景4.4 实战语义搜索示例5. 记忆维护最佳实践5.1 记忆写入原则5.2 记忆分类建议5.3 记忆清理策略5.4 安全注意事项6. 完整实战案例6.1 场景构建个性化 AI 助手6.2 场景多会话任务跟踪7. 记忆系统 API 参考7.1 memory_search7.2 memory_get7.3 自动记忆触发8. 常见问题与解决Q1记忆文件太大怎么办Q2如何避免记忆冲突Q3群聊中如何处理记忆Q4记忆搜索不准确怎么办9. 总结9.1 核心要点9.2 最佳实践清单9.3 下一步参考资料热门文章推荐OpenClaw 浏览器自动化实战OpenClaw 多模型配置与切换详解摘要本文深入探讨 OpenClaw 框架中的记忆系统设计与应用。从 MEMORY.md 长期记忆机制、memory/YYYY-MM-DD.md 每日日志、memory_search 语义搜索到记忆维护策略全面解析如何让 AI Agent 拥有持久化记忆能力。通过实际案例演示记忆的写入、检索、维护流程帮助开发者构建具有上下文连续性的智能应用解决 AI 健忘问题实现真正的个性化服务。1. 引言 - AI 的健忘问题1.1 为什么 AI 需要记忆你是否遇到过这样的场景场景问题影响多轮对话AI 忘记之前说过的话用户体验差个性化服务AI 不记得用户偏好每次都要重新说明长期任务AI 忘记任务进度无法持续跟进知识积累AI 学到的知识无法保存重复学习成本高传统 AI 系统的健忘问题本质上是上下文窗口有限和无持久化存储导致的。OpenClaw 通过记忆系统解决了这个问题。1.2 OpenClaw 记忆系统架构OpenClaw 提供了三层记忆架构 OpenClaw 记忆系统 语义检索 (memory_search)向量搜索相关性排序上下文召回 短期记忆 (memory/YYYY-MM-DD.md)每日工作日志临时任务记录会话摘要 长期记忆 (MEMORY.md)用户偏好重要决策关键知识项目上下文AI Agent1.3 记忆类型对比记忆类型文件用途生命周期长期记忆MEMORY.md用户偏好、重要决策、关键知识永久短期记忆memory/YYYY-MM-DD.md每日日志、临时记录定期归档会话记忆系统管理当前对话上下文会话结束2. MEMORY.md 长期记忆2.1 什么是 MEMORY.mdMEMORY.md 是 OpenClaw 的长期记忆存储用于保存用户个人信息和偏好重要决策和约定项目关键上下文需要跨会话记住的知识2.2 MEMORY.md 文件结构# MEMORY.md - 长期记忆 ## 用户信息 - 姓名张三 - 昵称老大 - 时区Asia/Shanghai - 语言偏好中文 ## 项目上下文 - 当前项目OpenClaw 技术文章撰写 - 目标完成100篇技术文章 - 进度已完成40篇 ## 重要决策 - 2026-03-14决定采用由浅入深的文章结构 - 2026-04-02选择飞书作为主要沟通渠道 ## 待办事项 - [ ] 完成第41篇记忆系统文章 - [ ] 整理文章截图 ## 注意事项 - 用户喜欢简洁的表达风格 - 文章需要包含代码示例和图表2.3 MEMORY.md 读写规则读取时机根据 AGENTS.md 的规定MEMORY.md只在主会话Main Session中加载### MEMORY.md - Your Long-Term Memory - **ONLY load in main session** (direct chats with your human) - **DO NOT load in shared contexts** (Discord, group chats, sessions with other people) - This is for **security** — contains personal context that shouldnt leak to strangers写入时机用户明确说记住这个做出重要决策时学习到需要长期保存的知识用户偏好发生变化时2.4 实战MEMORY.md 使用示例场景用户告诉 AI 自己的偏好用户我比较喜欢简洁的表达不要太啰嗦 AI好的我会记住你的偏好。让我更新 MEMORY.md...MEMORY.md 更新## 用户偏好 - 表达风格简洁不喜欢啰嗦 - 沟通语言中文3. memory/YYYY-MM-DD.md 每日日志3.1 什么是每日日志每日日志是 OpenClaw 的短期记忆存储用于记录当天完成的任务临时性的决定会话中的重要信息需要后续跟进的事项3.2 每日日志文件结构# 2026-04-13 工作记录 ## 完成的任务 ### 1. 撰写记忆系统文章 - 开始撰写第41篇文章 - 完成摘要和引言部分 ### 2. 用户反馈处理 - 用户要求调整文章结构 - 已按要求修改 ## 重要决策 - 决定将记忆系统作为独立章节 ## 待办事项 - [ ] 完成文章剩余部分 - [ ] 添加代码示例 ## 备注 - 用户今天心情不错3.3 日志写入时机时机内容任务完成记录完成的内容和结果重要对话记录用户的关键需求问题遇到记录问题和解决方案决策做出记录决策原因和结果3.4 日志维护策略否是是否每日日志超过7天?保留有重要内容?提取到MEMORY.md归档/删除4. memory_search 语义搜索4.1 什么是语义搜索memory_search 是 OpenClaw 提供的语义检索工具可以在 MEMORY.md 和每日日志中搜索相关内容基于语义相似度排序返回最相关的记忆片段4.2 memory_search 工具详解工具签名memory_search(query:str,# 搜索查询maxResults:int5,# 最大返回结果数minScore:float0.5# 最小相关性分数)返回格式{results:[{path:MEMORY.md,lines:10-15,content:用户偏好简洁表达风格,score:0.95},{path:memory/2026-04-10.md,lines:20-25,content:用户要求文章不要太长,score:0.82}]}4.3 使用场景场景查询示例回忆用户偏好“用户的表达风格偏好”查找历史决策“关于文章结构的决定”定位任务进度“当前项目进度”检索知识点“OpenClaw 配置相关”4.4 实战语义搜索示例场景用户问我们之前讨论的文章结构是什么样的# AI 内部调用memory_search(query文章结构 讨论,maxResults3)返回结果{results:[{path:MEMORY.md,content:文章结构由浅入深从入门到精通,score:0.91},{path:memory/2026-03-14.md,content:决定采用5阶段100篇文章的规划,score:0.85}]}AI 回复根据之前的讨论我们决定采用由浅入深的文章结构分为5个阶段共100篇文章。5. 记忆维护最佳实践5.1 记忆写入原则原则说明示例重要性只记录真正重要的内容✅ 用户偏好 ❌ 随口闲聊准确性确保信息准确无误核实后再写入时效性及时更新过时信息偏好变化时更新简洁性避免冗余信息提取关键点5.2 记忆分类建议# MEMORY.md 推荐结构 ## 用户信息 - 基本信息 - 沟通偏好 - 时区/语言 ## 项目上下文 - 当前项目 - 目标和进度 - 关键里程碑 ## 重要决策 - 决策内容 - 决策原因 - 决策时间 ## ⚠️ 注意事项 - 用户不喜欢的事情 - 需要避免的行为 - 特殊要求 ## 待办事项 - 长期待办 - 需要跟进的事项5.3 记忆清理策略是否是否定期检查记忆信息是否过时?删除或更新是否重要?保留在MEMORY.md归档到日志记录变更原因5.4 安全注意事项安全要求说明隐私保护不要记录敏感个人信息权限隔离MEMORY.md 不在群聊中加载数据加密敏感内容考虑加密存储访问控制限制记忆文件的访问权限6. 完整实战案例6.1 场景构建个性化 AI 助手目标让 AI 记住用户偏好提供个性化服务步骤1初始化 MEMORY.md# MEMORY.md ## 用户信息 - 姓名张龙生 - 昵称老大 - 时区Asia/Shanghai (GMT8) - 飞书用户 ## 沟通偏好 - 表达风格简洁直接不喜欢啰嗦 - 语言中文 - 回复格式表格 代码块 ## 项目上下文 - 当前项目OpenClaw 技术文章撰写 - 目标完成100篇技术文章 - 已完成40篇 ## 注意事项 - 文章需要包含 Mermaid 图表 - 代码示例要完整可运行 - 不要在群聊中透露个人信息步骤2日常使用中更新记忆用户我最近在研究飞书多维表格帮我记住 AI好的让我更新记忆... # 更新 MEMORY.md ## 当前关注 - 飞书多维表格Bitable开发步骤3使用语义搜索回忆用户我之前说的文章进度是多少来着 AI内部调用 memory_search 根据记忆你已完成40篇文章目标是100篇。6.2 场景多会话任务跟踪场景用户在多个会话中推进一个长期任务每日日志记录# 2026-04-13 工作记录 ## 任务进度 - 第41篇文章记忆系统 - ✅ 完成摘要和引言 - ✅ 完成 MEMORY.md 章节 - 进行中语义搜索章节 - ⏳ 待完成实战案例 ## 明日计划 - 完成第41篇文章 - 开始第42篇文章跨会话恢复用户昨天写到哪了 AI搜索 memory/2026-04-12.md 昨天你完成了第40篇文章多智能体协作进阶 今天应该继续写第41篇记忆系统。7. 记忆系统 API 参考7.1 memory_search# 语义搜索记忆memory_search(query用户的偏好,# 搜索查询maxResults5,# 返回结果数minScore0.5# 最小相关性分数)7.2 memory_get# 安全读取记忆片段memory_get(pathMEMORY.md,# 文件路径from10,# 起始行lines20# 读取行数)7.3 自动记忆触发OpenClaw 会在以下情况自动触发记忆操作触发条件操作会话开始读取 MEMORY.md会话结束写入每日日志用户说记住更新 MEMORY.md定时任务记忆归档整理8. 常见问题与解决Q1记忆文件太大怎么办解决方案定期清理过时信息将详细日志归档只保留关键信息在 MEMORY.mdQ2如何避免记忆冲突解决方案使用时间戳标记信息新信息覆盖旧信息时记录原因定期审查和合并重复信息Q3群聊中如何处理记忆解决方案MEMORY.md 不在群聊中加载群聊信息写入单独的日志敏感信息不记录到记忆Q4记忆搜索不准确怎么办解决方案优化查询关键词调整 minScore 阈值使用更具体的查询语句9. 总结9.1 核心要点要点说明三层架构长期记忆 短期记忆 语义检索安全隔离MEMORY.md 只在主会话加载语义搜索基于向量相似度的智能检索定期维护清理过时信息归档历史日志9.2 最佳实践清单为每个用户创建 MEMORY.md每日记录工作日志定期清理和归档记忆使用语义搜索快速定位信息注意隐私和安全保护9.3 下一步第42篇OpenClaw 日志记忆memory/YYYY-MM-DD.md第43篇OpenClaw memory_search语义搜索实战第44篇OpenClaw 记忆维护自动整理与归档参考资料OpenClaw 官方文档OpenClaw GitHubAGENTS.md 记忆系统说明