"凌晨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)来组织记忆:
scene: "日常对话"- 通用偏好scene: "项目管理"- 项目相关信息scene: "技术栈"- 技术偏好和配置
隐私提醒:
• 敏感信息(密码、密钥)不应该存入长期记忆
• 用户明确表示要遗忘的内容应该尊重
• 记忆搜索返回的内容需要验证时效性
• 敏感信息(密码、密钥)不应该存入长期记忆
• 用户明确表示要遗忘的内容应该尊重
• 记忆搜索返回的内容需要验证时效性
📚 相关链接
OpenClaw Agent创建指南
创建和管理多个Agent实例
OpenClaw自动化入门
自动化工作流的基础知识
AI记忆系统详解
术语百科:记忆系统的类型和原理
多Agent协作工作流
多个Agent如何共享记忆