OpenClaw Agent 记忆持久化完全指南：让 AI 记住一切

一个没有记忆的 Agent 就像一个每天失忆的人——每次对话都要从头开始。OpenClaw 的记忆持久化系统通过三层记忆架构（会话记忆、工作区记忆、长期记忆），让 Agent 能够积累经验、学习偏好、持续进化。

🧠 三层记忆架构

🔵 会话记忆（Session Memory）

当前对话的上下文，会话结束后自动清理。存储在内存中，速度最快。

🟣 工作区记忆（Workspace Memory）

SOUL.md、USER.md、TOOLS.md 等工作区文件，跨会话持久化。存储在文件系统中。

🔵 长期记忆（Long-term Memory）

MEMORY.md 和结构化记忆数据库，存储重要事实、用户偏好、历史决策。支持语义搜索。

⚙️ 记忆配置

{
  "memory": {
    "session": { "maxTokens": 8192, "compression": "smart" },
    "workspace": { "autoLoad": ["SOUL.md", "USER.md", "TOOLS.md"], "watchChanges": true },
    "longterm": { "enabled": true, "backend": "sqlite", "maxEntries": 10000, "autoSummarize": true }
  }
}
    

📝 工作区文件详解

文件	用途	更新频率
SOUL.md	Agent 人格、语气、行为准则	很少更新
USER.md	用户信息、偏好、工作内容	偶尔更新
TOOLS.md	工具配置、API 密钥、常用命令	经常更新
MEMORY.md	重要事实、长期决策、经验教训	经常更新
IDENTITY.md	Agent 身份信息	很少更新

💡 最佳实践

1. 结构化记忆

不要让 MEMORY.md 变成杂乱无章的笔记本，使用分类和标签：

# MEMORY.md 结构示例

## 用户偏好
- 偏好简洁的中文回复
- 喜欢用 Markdown 格式
- 工作时间 9:00-18:00

## 项目信息
- 网站: miaoquai.com
- 技术栈: OpenClaw + Nginx + Node.js

## 经验教训
- [2026-06-01] sitemap.xml 超过 5000 条时需要分片
- [2026-05-15] Discord 消息长度限制 2000 字符

## 待办事项
- [ ] 配置 GitHub Token
- [ ] 创建 RSS XML 源
    

2. 定期清理

记忆会随时间增长，定期清理过时信息：

# 查看记忆统计
openclaw memory stats

# 清理过时记忆
openclaw memory prune --older-than=30d

# 导出记忆备份
openclaw memory export --output=memory-backup.json
    

3. 语义搜索

长期记忆支持语义搜索，可以用自然语言查询：

# 在 Agent 对话中使用
"帮我回忆一下上次关于 Discord 机器人配置的讨论"

# 或使用 CLI
openclaw memory search "Discord 机器人配置"
    

✅ 建议：将重要的工作成果和经验教训及时写入 MEMORY.md，让 Agent 能够在未来的对话中引用这些知识。