🧠 OpenClaw记忆管理指南

让Agent记住你们聊过什么——从金鱼脑到最强大脑

📅 2026-04-15 ⏱️ 阅读12分钟 🏷️ OpenClaw核心功能
"凌晨2点13分,我问Agent:'还记得我上周说的那个需求吗?'它沉默了三秒,然后说:'当然记得,你当时说要做一个能自动抢茅台的脚本,但因为太懒所以放弃了。' 那一刻,我感觉它比我还了解我自己。"
世界上有一种尴尬叫"我说了但你忘了"。传统的AI对话每次都要重新开始,就像跟一个金鱼脑的朋友聊天。而OpenClaw的记忆系统,让Agent能够记住你们的对话历史、你的偏好、甚至是那些你自己都忘了的小事。

🧠 记忆系统架构

OpenClaw的记忆系统分为两个层次,就像人的短期记忆和长期记忆:

L0原始对话层(conversation_search)- 完整记录每一条消息
L1结构化记忆层(tdai_memory_search)- 提取的精华,包括人设、事件、指令

🔍 记忆搜索工具详解

工具用途查询类型
tdai_memory_search搜索结构化记忆偏好、规则、历史决策
tdai_conversation_search搜索原始对话具体说了什么、时间线

使用 tdai_memory_search

搜索用户的偏好设置
// 搜索关于用户工作偏好的记忆
tdai_memory_search({
  query: "用户喜欢什么工作方式",
  type: "persona",
  limit: 5
})

// 搜索特定场景的记忆
tdai_memory_search({
  query: "GitHub自动化配置",
  scene: "Agent社区运营",
  limit: 10
})

使用 tdai_conversation_search

查找具体对话内容
// 搜索昨天关于部署的讨论
tdai_conversation_search({
  query: "服务器部署配置",
  limit: 10
})

// 搜索特定会话的对话
tdai_conversation_search({
  query: "定时任务设置",
  session_key: "session_abc123",
  limit: 5
})
什么时候用什么?
• 想知道"用户之前说过喜欢什么" → 用 tdai_memory_search
• 想知道"昨天我具体说了什么话" → 用 tdai_conversation_search

📝 记忆的最佳实践

1. 会话开始时读取记忆

每次会话启动时,Agent应该主动读取相关记忆,了解用户身份和当前上下文。

2. 重要信息回写记忆

当用户传达了重要信息时,应该在任务完成后回写到记忆系统,格式建议:

记忆回写内容格式
## 用户重要偏好记录
- 用户喜欢幽默风趣的回复风格
- 用户对代码质量要求很高
- 用户正在做的项目:妙趣AI网站
- 用户的老板叫"诗中"
- 用户的时区:Asia/Shanghai

3. 场景化记忆管理

使用场景(scene)来组织记忆:

隐私提醒:
• 敏感信息(密码、密钥)不应该存入长期记忆
• 用户明确表示要遗忘的内容应该尊重
• 记忆搜索返回的内容需要验证时效性

📚 相关链接