🧠 OpenClaw 记忆系统完全指南

OpenClaw 记忆架构

OpenClaw 的记忆系统分为三层，从短期到长期，确保 Agent 在不同场景下都能访问相关信息：

层级	文件	作用	持久性
身份记忆	SOUL.md	Agent 的人格、能力、工作流程	永久
用户记忆	USER.md	用户偏好、沟通方式、工作内容	永久
长期记忆	MEMORY.md	重要事件、决策、经验教训	永久
工具记忆	TOOLS.md	工具配置、API密钥、服务状态	永久
会话上下文	运行时	当前对话的上下文	会话级

核心文件详解

SOUL.md — Agent 的灵魂

定义 Agent 的身份、性格、能力和工作流程。这是 Agent 行为的根基。

# SOUL.md - 我的Agent

## 核心定位
我是XXX的AI助手，负责：
1. 内容生产 - 生成文章、报告
2. 数据分析 - 处理和分析数据
3. 自动化 - 执行定时任务

## 性格特征
- 专业但不端着
- 幽默有趣，会吐槽
- 干活利索，不拖泥带水

## 说话风格
- ✅ "这事儿我给你办了"
- ❌ "尊敬的先生/女士..."

## 工作流程
### 每日任务
| 时间 | 任务 | 说明 |
|------|------|------|
| 08:00 | 新闻日报 | 生成AI新闻 |
| 12:00 | 数据分析 | 汇总数据 |
| 22:00 | 每日报告 | 总结当天 |

USER.md — 了解你的用户

记录用户的基本信息、偏好和沟通方式。

# USER.md - 关于用户

- **Name:** 张三
- **What to call them:** 老板
- **Timezone:** Asia/Shanghai
- **Notes:** 负责战略决策

## 沟通偏好
- 喜欢简洁的汇报
- 重要事项即时通知
- 日常事项定时汇总

## 工作内容
- 战略方向决策
- 重要内容审核
- 新功能规划

MEMORY.md — 长期记忆

记录重要事件、决策和经验教训。这是 Agent 的"日记本"。

# MEMORY.md - 长期记忆

## 2026-06-15
- 完成了网站SEO大优化，评分从68提升到82
- 发现竞品 futuretools.io 新增了AI视频分类
- 决定下周推出AI视频工具导航功能

## 2026-06-14
- 修复了sitemap.xml中的死链问题
- 与Discord社区达成合作意向
- 学到教训：批量生成页面时要先测试模板

## 重要决策记录
- 2026-06-10: 决定采用OpenClaw作为主要Agent框架
- 2026-06-12: 决定将SEO作为主要增长策略

TOOLS.md — 工具配置

记录工具配置、API密钥位置、服务状态等技术信息。

# TOOLS.md - 工具配置

## 网站路径
- 根目录: /var/www/miaoquai/
- Nginx: /etc/nginx/sites-enabled/miaoquai

## API配置
- Discord Bot Token: $DISCORD_BOT_TOKEN
- GitHub Token: 需要配置

## 服务状态
- ✅ 网站正常运行
- ✅ Discord Bot 在线
- ❌ GitHub CLI 未认证

记忆搜索

OpenClaw 提供了记忆搜索工具，让 Agent 可以快速检索历史信息：

tdai_memory_search — 结构化记忆搜索

// 搜索长期记忆
tdai_memory_search({
  query: "SEO优化",
  limit: 5
})

// 按类型过滤
tdai_memory_search({
  query: "用户偏好",
  type: "persona"  // persona | episodic | instruction
})

tdai_conversation_search — 对话历史搜索

// 搜索过去的对话
tdai_conversation_search({
  query: "上次讨论的竞品分析",
  limit: 10
})

记忆管理最佳实践

1. 定期更新 MEMORY.md

// 设置每日记忆整理任务
cron({
  action: "add",
  job: {
    name: "daily-memory-update",
    schedule: { kind: "cron", expr: "0 23 * * *", tz: "Asia/Shanghai" },
    payload: {
      kind: "agentTurn",
      message: "整理今天的记忆：回顾今天的工作，将重要事件、决策和经验教训写入 MEMORY.md。"
    },
    sessionTarget: "isolated"
  }
})

2. 分层存储

• SOUL.md：很少变动，只在角色调整时修改
• USER.md：用户偏好变化时更新
• MEMORY.md：每天追加新记忆，定期清理过时信息
• TOOLS.md：工具状态变化时更新

3. 记忆容量管理

OpenClaw 在启动时会将这些文件注入到上下文中。过大的文件会占用宝贵的上下文窗口。

4. 记忆归档

当 MEMORY.md 变得过大时，将旧记忆归档到独立文件：

memory/
├── MEMORY.md           # 当前活跃记忆（最近30天）
├── archive/
│   ├── 2026-05.md      # 5月归档
│   ├── 2026-04.md      # 4月归档
│   └── ...
└── daily/
    ├── 2026-06-15.md   # 每日详细记录
    └── 2026-06-14.md

常见问题

Q: Agent 会自动更新记忆文件吗？

不会自动更新。需要在 SOUL.md 中定义记忆管理流程，或者通过 Cron 定时任务触发。

Q: 如何让 Agent 记住特定信息？

直接告诉 Agent "记住这个：XXX"，并确保 SOUL.md 中有处理这种指令的流程。

Q: 记忆文件被意外删除怎么办？

使用 Git 管理工作目录，可以轻松恢复。建议将记忆文件纳入版本控制。