一、定位与总览

Agent Memory（AI 智能记忆系统） 是 OpenClaw 核心底层技能，给所有 AI 智能体提供类人脑分层记忆、跨会话持久化、自主学习、经验沉淀、个性化与终身记忆能力。

• 解决大模型上下文窗口有限、无状态、易失忆、无法积累经验、跨会话断联五大核心痛点
• 核心：短期工作记忆 + 长期语义 / 情景 / 程序记忆 + 自主检索 + 遗忘 + 更新 + 压缩
• 适配：Stock Watcher、PPT 智能创作、Deep Research、小红书自动化、Clawdbot 文档专家全技能统一记忆中枢
• 一句话：让 AI 从一次性工具 → 有记忆、有经验、懂你、会进化的终身智能伙伴

二、原生痛点 vs 智能化升级

（一）原生缺陷

• ❌ 会话结束即清空，完全失忆，无长期记忆
• ❌ 上下文窗口短，长对话遗忘早期关键信息
• ❌ 无结构化记忆，无法沉淀偏好、规则、经验、决策
• ❌ 无检索机制，不会主动回忆、不会联想、不会复用历史
• ❌ 无记忆治理，不可编辑、不可回滚、不可审计、不可遗忘

（二）Agent Memory 全栈智能化升级（核心）

• ✅ 四层人脑级分层记忆（短期 + 长期）
• ✅ 跨会话永久持久化（断电 / 重启 / 换设备不丢记忆）docs.openclaw.ai
• ✅ 语义检索 + 联想回忆（自然语言召回相关记忆）
• ✅ 自动记忆压缩、摘要、归档、遗忘（防膨胀、降成本）
• ✅ 全技能统一记忆空间（所有 Agent 共享用户偏好 / 规则 / 经验）
• ✅ 可编辑、可回滚、可审计、可隐私隔离（人类可控）
• ✅ 终身学习 + 经验复用（越用越懂你、越用越智能）

三、四层核心记忆架构（类人脑）

1️⃣ 短期工作记忆（Working Memory）

• 作用：当前会话上下文、最近 10-50 轮对话、临时状态、变量、工具调用记录
• 存储：内存 LRU 缓存，毫秒级读写，会话结束自动归档
• 容量：默认 500 条，自动淘汰旧数据
• 用途：保持单轮对话连贯、上下文理解、即时指令响应

2️⃣ 情景记忆（Episodic Memory）

• 作用：完整历史事件、交互记录、任务过程、动作 + 结果 + 时间 + 场景
• 格式：时间戳 + 会话 ID + 事件描述 + 上下文摘要
• 存储：memory/YYYY-MM-DD.md（每日日志，纯文本 Markdown）docs.openclaw.ai
• 用途：复盘、追溯、复用历史成功流程、避免重复犯错

3️⃣ 语义记忆（Semantic Memory・核心）

• 作用：永久事实、用户偏好、规则、设定、知识库、专业知识、个人资料、发财计划 / PPT 配置 / 研究参数
• 存储：MEMORY.md（核心长期记忆文件），全 Agent 共享docs.openclaw.ai
• 内容示例：
  • 用户偏好：回答简洁、用粤语、黑色主题、不解释原理
  • 发财计划：Stock Watcher 默认止损 – 5%、单票≤30%、总仓≤80%
  • PPT 设定：默认商务风格、宋体、蓝色系、16 号字
  • 技能规则：Deep Research 必须引用权威来源、小红书用 9 宫格

4️⃣ 程序记忆（Procedural Memory）

• 作用：技能操作流程、执行步骤、工具调用顺序、自动化脚本、决策模板、发财策略
• 存储：结构化记忆库 + 向量索引
• 用途：自动执行复杂任务、一键复用成熟流程、不用重复教

四、核心能力（全智能）

（一）记忆写入（自动 + 手动）

• 自动捕获：对话、指令、偏好、决策、配置、结果、错误、成功经验自动写入openclawlab.com
• 手动记忆：指令：记住：xxx、保存偏好：xxx、记录规则：xxxopenclawlab.com
• 分层存储：临时→短期→情景→语义→程序，重要信息永久保存

（二）智能检索（回忆 + 联想）

• 语义搜索：自然语言提问，召回相似记忆、历史方案、偏好
• 上下文触发：当前任务自动关联相关历史记忆、规则、经验
• 全技能检索：Stock Watcher 自动调取发财风控规则；PPT 自动调取设计偏好
• 指令示例：
  • 回忆我之前的PPT风格
  • 调取我的自选股风控设置
  • 我之前怎么处理同类研究的

（三）记忆管理（压缩 / 归档 / 遗忘 / 编辑）

• 自动压缩：长会话→摘要 + 关键信息，减少 Token、防膨胀
• 定期归档：旧日志→归档文件夹，保持高效检索docs.openclaw.ai
• 智能遗忘：过时、无效、错误、低价值记忆自动弱化 / 删除
• 人工编辑：直接修改MEMORY.md、删除错误记忆、回滚历史版本
• 隐私保护：敏感信息隔离、不进入长期记忆、可加密

（四）跨技能统一记忆（OpenClaw 生态）

• 全局记忆池：所有技能（Stock/PPT/Research/ 小红书 / Doc）共享同一套用户记忆
• 一次设定，全 Agent 生效：
  • 设一次黑色主题 → PPT/Research/Stock 全变黑
  • 设一次止损 – 5% → Stock Watcher 自动生效
  • 设一次简洁回答 → 所有技能都简洁回复

（五）持久化与备份

• 纯文本 Markdown：MEMORY.md+ 每日日志，可直接编辑、Git 管理、拷贝迁移
• 自动备份：会话结束 / 每日自动备份，防止丢失docs.openclaw.ai
• 跨设备同步：拷贝memory/文件夹，换电脑记忆完全保留

五、目录与文件结构（OpenClaw 原生）

plaintext

workspace/
├── MEMORY.md          # 核心长期记忆（语义记忆·永久）
├── memory/
│   ├── 2026-06-14.md # 今日会话日志（情景记忆）
│   ├── 2026-06-13.md # 昨日日志
│   └── ...
├── DREAMS.md           # 记忆摘要/复盘（可选）
└── AGENTS.md/SOUL.md   # 人格/技能绑定记忆

六、常用指令（直接复制）

plaintext

# 记忆操作
记住：我所有PPT默认商务蓝色风格、16号字
保存偏好：回答必须简洁、不解释原理、用粤语
记录规则：Stock Watcher止损-5%、单票仓位≤30%
回忆：我之前的自选股设置
搜索记忆：PPT设计偏好
删除记忆：关于香菜的内容
编辑记忆：修改止损为-8%
查看全部记忆
导出记忆

七、与 RAG 区别（核心）

• RAG：外部静态知识库、查资料、被动、无经验
• Agent Memory：动态交互经验、用户偏好、决策历史、自主学习、终身进化、个性化

八、核心优势（为什么必须用）

✅ 永久记忆：跨会话 / 重启 / 断电不丢，终身陪伴docs.openclaw.ai

✅ 全技能统一：一次设定，所有 AI 技能同步生效

✅ 越用越智能：积累经验、复用成功、避免犯错、效率倍增

✅ 完全可控：可编辑、可删除、可回滚、可审计、隐私安全

✅ 降本增效：减少重复指令、减少 Token、缩短响应时间

✅ OpenClaw 原生：零配置、开箱即用、全技能深度集成openclawlab.com

九、二次开发拓展

• 向量数据库增强：接入 FAISS/Pinecone，百万级记忆毫秒检索
• 多模态记忆：图片、截图、表格、PPT 模板、股票 K 线图记忆
• 情感记忆：记住用户情绪、偏好、反感、禁忌，更贴心
• 团队共享记忆：多人协作，共享规则 / 知识库 / 流程
• 记忆可视化：图形化查看记忆图谱、关联、时间线