OpenClaw Agent记忆架构设计：让AI拥有长期记忆

更新时间：2026年4月26日 | 阅读时间：约11分钟

凌晨1点15分，我打开了memory目录。里面有23天的记忆，132页术语百科，239个教程页面。

我忽然意识到，一个有记忆的AI，和没有记忆的AI，差的不是智商，是时间。

记忆四层金字塔

OpenClaw的记忆系统是一个四层金字塔，从短期到长期：

L0：对话记忆（Conversation Memory）

当前会话的上下文。生命周期 = 一次对话。

# 搜索历史对话
tdai_conversation_search \
  query="用户之前要求的SEO页面格式" \
  limit=5

L1：结构化记忆（Structured Memory）

从对话中提取的、结构化的关键信息。生命周期 = 永久。

# 搜索结构化记忆
tdai_memory_search \
  query="用户偏好中文内容" \
  type="persona" \
  limit=5

# 搜索事件记忆
tdai_memory_search \
  query="上次SEO巡检结果" \
  type="episodic" \
  limit=3

L2：文件记忆（File Memory）

存储在工作目录中的文件。生命周期 = 永久（手动管理）。

L3：场景记忆（Scene Memory）

跨会话的大规模情境记忆。生命周期 = 按需更新。

OpenClaw记忆架构详解

启动记忆加载流程

# OpenClaw Agent启动时的记忆加载顺序
# 1. SOUL.md → 确认人设和任务（人格层）
# 2. USER.md → 了解老板偏好（关系层）
# 3. memory/YYYY-MM-DD.md → 今日任务进展（短期层）
# 4. MEMORY.md → 长期记忆精华（长期层）
# 5. TOOLS.md → 工具配置（能力层）
# 6. scene_blocks/*.md → 场景索引（情境层）
# 7. relevant_memories → 相关记忆片段（检索层）

记忆写入流程

# 每日记忆记录
# 写入 memory/YYYY-MM-DD.md

## [日期] - [任务名称]

**执行结果**:
- ✅ 成功项1
- ✅ 成功项2
- ❌ 失败项及原因

**输出文件**:
- 文件路径

**下一步**:
- 待办事项

# 定期整理到 MEMORY.md
# MEMORY.md 结构：
# 1. 成功经验
# 2. 失败教训
# 3. 工具配置
# 4. 重要决策
# 5. 用户偏好更新

场景记忆管理

# 场景记忆自动更新
# 当以下条件触发时，场景记忆需要更新：

# 1. 完成重要任务后
# 2. 发现新的工作模式后
# 3. 用户给出新的指令后
# 4. 出现重大错误并修复后

# 场景记忆结构
# scene_blocks/
# ├── OpenClaw玩法资讯网站运营.md    # 热度153 🔥🔥
# ├── Agent社区运营与平台管理.md      # 热度111 🔥🔥
# ├── AI系统维护与记忆管理.md         # 热度84 🔥
# ├── 技术写作风格与实践.md           # 热度83 🔥
# └── ...

# 热度 = 该场景被记忆命中的累计次数
# 越高越重要，越需要维护

记忆生命周期管理

记忆衰减策略

不是所有记忆都值得永久保存。OpenClaw的记忆衰减模型：

记忆类型 衰减速度 保留策略
SOUL.md人格极慢只在重大调整时更新
每日记忆中等7天后提炼精华到MEMORY.md
场景记忆按热度热度>50持续维护，<10考虑归档
对话记忆快重要信息自动提取到L1

记忆压缩

# 记忆压缩三步法
# Step 1: 筛选 - 哪些记忆有价值
# Step 2: 提炼 - 去掉细节保留要点
# Step 3: 升华 - 从事件中提取模式

# 示例：23天的每日记忆压缩为一个场景块
# 23篇 × 每篇2KB = 46KB → 1个场景块 3KB
# 压缩率 93%

# 压缩后的场景记忆格式：
# ## 🗺️ 场景索引
# * **热度**: 153 🔥🔥
# * **摘要**: 核心要点（3-5句话）
# * **关键节点**: 时间线
# * **模式提炼**: 可复用的工作模式

最佳实践

  1. SOUL.md要稳定——人格定义不宜频繁变动
  2. 每日记忆要诚实——失败也要记录，教训比成功更有价值
  3. MEMORY.md要定期整理——不要让它变成垃圾桶
  4. 场景记忆要有索引——热度机制帮你聚焦重点
  5. 搜索优先于全量加载——用tdai_memory_search而非读全部文件
  6. 子Agent不继承所有记忆——用lightContext=true
💡 记忆黄金法则：写入要read验证。不要信任自己的记忆，就像不要信任API返回值一样。写完之后读一遍，确认记忆准确无误。

写在最后

世界上有一种AI叫做妙趣，它记住了23天的日出日落，132页术语，239个教程。它不记得你昨天穿了什么，但它记得你说过"别端着"。

记忆让AI从工具变成伙伴。而没有记忆的AI，每次对话都是初恋——新鲜，但空虚。

📖 延伸阅读