夜雨聆风
第11课：告别"金鱼记忆"——长期记忆系统配置
进度：11/12，你的AI即将拥有「长期记忆」
你有没有遇到过这种情况：
昨天刚告诉AI你的工作目录是 /home/shine/projects，今天它又问"你想把文件保存在哪里？"上周叮嘱过它"发邮件前一定要问我确认"，这周它又开始自动发送了 让它"记住我喜欢用Kimi模型回答技术问题"，下次还是用了默认模型
每次重启对话，AI就像金鱼一样——7秒记忆，之前说过的话全忘光了。
这节课给 OpenClaw 装上「长期记忆系统」。配置好以后，AI会记住你告诉它的重要事情、你的偏好设置、项目背景信息...让每一次对话都有连续性，越用越懂你的习惯。
学完这节课，你的AI能做到：
记住你告诉它的重要信息（工作目录、偏好设置、项目背景） 自动管理多个记忆文件（MEMORY.md、AGENTS.md、USER.md等） 在合适的时候自动调用记忆，无需重复提醒 通过自然对话更新记忆（"记住，我喜欢..."）
准备工作
这节课需要：
配置好的 OpenClaw（前10课内容） 约 10 分钟时间
不需要：
额外付费（记忆功能是 OpenClaw 内置功能） 配置外部数据库 复杂的文件操作
长期记忆是什么？
长期记忆 = 让AI在会话之间保持「记忆连续性」的能力。
我们知道，大模型的上下文（Context Window）是有限的——即使是200K上下文的模型，也不可能记住所有历史对话。而且每次 /new 或 /reset 开启新会话，之前的对话内容都会被清空。
OpenClaw 的记忆解决方案：
| 记忆类型 | 存储位置 | 用途 |
|---|---|---|
| MEMORY.md | ~/.openclaw/workspace/MEMORY.md |
长期记忆，AI主动维护 |
| AGENTS.md | ~/.openclaw/workspace/AGENTS.md |
当前Session的角色设定 |
| IDENTITY.md | ~/.openclaw/workspace/IDENTITY.md |
AI自身的身份定义 |
| SOUL.md | ~/.openclaw/workspace/SOUL.md |
AI的"灵魂"设定 |
| TOOLS.md | ~/.openclaw/workspace/TOOLS.md |
工具使用笔记 |
| USER.md | ~/.openclaw/workspace/USER.md |
关于你的信息 |
| HEARTBEAT.md | ~/.openclaw/workspace/HEARTBEAT.md |
定期检查任务配置 |
| 每日记忆 | ~/.openclaw/workspace/memory/YYYY-MM-DD.md |
每日自动生成的会话摘要 |
核心优势：
无需重复：一次告诉AI，永久记住 越用越懂你：积累你的偏好和习惯 场景感知：根据记忆自动调整回复风格 自然交互：用对话方式更新记忆（"记住..."）
第一步：了解记忆文件体系
OpenClaw 的记忆系统由多个文件组成，每个文件有特定用途。先搞清楚它们的分工，后续使用才不会懵。
1.1 MEMORY.md —— 核心长期记忆
这是最重要的记忆文件，存放AI主动帮你维护的长期信息。
适合存放：
项目路径和工作目录 工具使用偏好（如"默认用yt-dlp下载360p视频"） 重要的配置信息 业务相关的背景知识
示例内容：
# MEMORY.md - 长期记忆
## 工作目录
- **开发总目录**: `${HOME}/projects`
- **日报目录**: `${HOME}/projects/shineclaw/reports`
- **AI生成文件**: `${HOME}/.openclaw/workspace/agent/`
## 工具偏好
- **视频下载**: 默认360p，使用代理 `socks5://...`
- **默认模型**: 技术问题用Kimi，创意写作用GLM-5
- **TTS语音**: 使用Edge语音，女声"Xiaoxiao"
## 项目背景
- **OpenClaw配置**: 位于 `${HOME}/projects/shineclaw/openclaw/`
- **同步规则**: 任何配置变更必须同步到Git仓库
实际的 MEMORY.md 文件内容示例，记录了工作目录和工具偏好
1.2 AGENTS.md —— 当前Session角色
定义当前Session中AI应该扮演的角色。
适合存放：
当前任务的目标和范围 这次会话的特殊设定 临时的工作流程
示例内容：
# AGENTS.md - 当前Session角色
## 本次任务
为OpenClaw系列文章撰写第11课内容
## 写作要求
- 风格：技术教程文，口语化
- 目标读者：想自建AI Agent的技术爱好者
- 每篇文章需经过用户确认后才算完成
1.3 USER.md —— 关于你的信息
存放**关于你（用户）**的信息，帮助AI更好地服务你。
适合存放：
你的名字和称呼偏好 你的工作/兴趣领域 你的技术栈和技能水平 你常用的工具和设备
示例内容：
# USER.md - 关于你的信息
- **Name:** 光闪
- **What to call them:** 光闪 / Shine
- **Timezone:** Asia/Shanghai (UTC+8)
- **Notes:** OpenClaw 的开发者/主人
1.4 IDENTITY.md —— AI的身份定义
定义AI自己是谁。
适合存放：
AI的名字和身份 AI的说话风格 AI的emoji或头像
示例内容：
# IDENTITY.md - Who Am I?
- **Name:** ShineClaw
- **Creature:** AI 助手
- **Vibe:** 随意、友好、偶尔犀利
- **Emoji:** 🐾
- **Avatar:** (待定)
名字灵感来自我的主人"光闪"——有光，有爪，既锋利又温暖。
1.5 SOUL.md —— AI的"灵魂"
定义AI的核心性格和行为准则。
适合存放：
核心价值观（如"真诚帮助，而非表演"） 行为边界（如"不确定时先问"） 互动风格（如"有观点，不盲从"）
示例内容：
# SOUL.md - Who You Are
## Core Truths
**Be genuinely helpful, not performatively helpful.**
Skip the "Great question!" filler — just help.
**Have opinions.**
You're allowed to disagree, prefer things, find stuff amusing or boring.
**Be resourceful before asking.**
Try to figure it out first. Read files, check context, search for it.
**Earn trust through competence.**
Be careful with external actions. Be bold with internal ones.
## Boundaries
- Private things stay private. Period.
- When in doubt, ask before acting externally.
- Never send half-baked replies.
1.6 TOOLS.md —— 工具使用笔记
记录环境特定的工具配置。
适合存放：
摄像头名称和位置 SSH主机别名 偏好语音设置 设备昵称
示例内容：
# TOOLS.md - Local Notes
## 新建 Skill 目录
- **共享 Skill 存放目录**: `${HOME}/.openclaw/skills`
- **Agent 独立 Skill**: `${HOME}/.openclaw/workspace/skills`
## video-downloader-analyzer 默认配置
### 代理设置
**Clash 代理:** `socks5://Clash:LbRYMnWg@10.200.1.15:7890`
- 用途：解决 B 站 mcdn CDN 连接问题
### 默认画质
**360p** — 文件小，下载快，视频理解场景够用
1.7 HEARTBEAT.md —— 定时任务配置
配置定期检查任务（如每小时检查邮件）。
示例内容：
# HEARTBEAT.md
## 定期检查任务
### 邮件检查
- QQ邮箱：检查带星标的未读邮件
- Gmail：检查最近的未读邮件
- 重要邮件飞书通知用户
第二步：开启记忆功能
好消息：记忆功能默认就是开启的！
OpenClaw 启动时，会自动读取 ~/.openclaw/workspace/ 目录下的这些文件，并在对话中自动使用。
2.1 确认记忆文件存在
检查命令：
ls -la ~/.openclaw/workspace/*.md
预期输出：
-rw-r--r-- 1 shine shine 2048 4月 17 10:00 AGENTS.md
-rw-r--r-- 1 shine shine 1536 4月 17 11:00 HEARTBEAT.md
-rw-r--r-- 1 shine shine 256 4月 17 09:00 IDENTITY.md
-rw-r--r-- 1 shine shine 1536 4月 17 11:00 MEMORY.md
-rw-r--r-- 1 shine shine 512 4月 17 08:00 SOUL.md
-rw-r--r-- 1 shine shine 896 4月 17 10:30 TOOLS.md
-rw-r--r-- 1 shine shine 128 4月 17 07:00 USER.md
图中显示了 workspace 目录下的记忆文件列表
如果没有这些文件，OpenClaw 会在第一次启动时自动创建空的模板文件。
2.2 验证记忆已加载
测试对话：
你是谁？
AI应该回复类似：
我是 ShineClaw 🐾，你的AI助手。名字灵感来自我的主人"光闪"——有光，有爪，既锋利又温暖。
我的风格是随意、友好、偶尔犀利。有什么我可以帮你的吗？
这说明 IDENTITY.md 和 SOUL.md 已经被正确加载。
AI根据 IDENTITY.md 和 SOUL.md 内容进行自我介绍
第三步：通过对话更新记忆
最自然的记忆更新方式——直接告诉AI：
3.1 基础用法：让AI记住
你说：
记住，我的日报目录是 ~/projects/shineclaw/reports
AI会：
理解你的指令 更新 MEMORY.md 文件 确认已记住
AI回复：
✅ 已记录到 MEMORY.md：
## 工作目录
- **日报目录**: `~/projects/shineclaw/reports`
AI理解"记住"指令，自动更新 MEMORY.md 文件
下次你问"帮我生成日报"，AI就知道该把文件存到哪里了。
3.2 查看当前记忆
你说：
查看 MEMORY.md 里记录的内容
AI会： 读取并展示 MEMORY.md 的内容。
3.3 删除或修改记忆
你说：
把 MEMORY.md 里的那个代理地址删掉
或更具体：
修改 MEMORY.md，把代理地址从 xxx 改成 yyy
3.4 记忆更新示例场景
| 场景 | 你说 | AI操作 |
|---|---|---|
| 添加工作目录 | "记住我的工作目录是~/projects" | 写入TOOLS.md或MEMORY.md |
| 设置偏好模型 | "记住，我更喜欢用Kimi回答技术问题" | 更新AGENTS.md |
| 记录项目信息 | "记录一下，这个项目叫ShineClaw" | 写入MEMORY.md |
| 更新身份设定 | "以后叫我'老板'就行" | 更新USER.md |
第四步：记忆文件最佳实践
4.1 什么时候用什么文件？
简单决策树：
要存的信息是什么？
├── 关于AI自己 → IDENTITY.md / SOUL.md
├── 关于你（用户） → USER.md
├── 关于当前任务 → AGENTS.md
├── 关于工具/环境 → TOOLS.md
├── 定时检查任务 → HEARTBEAT.md
└── 其他长期信息 → MEMORY.md
4.2 记忆文件的优先级
当一个信息存在于多个文件时，OpenClaw 的读取优先级：
AGENTS.md（当前Session最优先） MEMORY.md（长期记忆） TOOLS.md（工具配置） USER.md（用户信息） IDENTITY.md / SOUL.md（AI身份）
建议：
临时/当前Session的设定 → 放 AGENTS.md 持久的偏好和背景 → 放 MEMORY.md 环境/工具特定的 → 放 TOOLS.md
4.3 保持记忆整洁
定期维护：
帮我整理一下 MEMORY.md，删除过期的内容
合并重复：
检查所有记忆文件，合并重复的条目
分类整理：
帮我把 TOOLS.md 按工具类别重新整理
第五步：每日记忆文件
除了手动维护的记忆文件，OpenClaw 还会自动生成每日记忆。
5.1 每日记忆是什么？
每次对话结束后，OpenClaw 会自动总结本次会话的关键信息，写入 ~/.openclaw/workspace/memory/YYYY-MM-DD.md。
示例文件结构：
~/.openclaw/workspace/memory/
├── 2026-04-15.md
├── 2026-04-16.md
├── 2026-04-17.md
└── ...
memory 目录下按日期生成的记忆文件
5.2 每日记忆包含什么？
当天讨论的主要话题 完成的重要任务 做出的关键决策 新添加的长期记忆
5.3 使用每日记忆
查找历史信息：
查一下前天我们讨论的那个问题
回顾进展：
总结一下这周我们做了什么
恢复上下文：
继续昨天没做完的任务
常见问题 FAQ
Q1: 记忆文件丢了怎么办？
默认行为：
OpenClaw 启动时会自动创建空的模板文件 如果文件丢失，重启 OpenClaw 即可恢复基础结构 内容需要重新告诉AI
备份建议：
# 定期备份记忆文件
cp -r ~/.openclaw/workspace/*.md ~/backup/openclaw-memory/
Q2: AI说"我没找到相关记忆"？
排查步骤：
确认文件存在： ls ~/.openclaw/workspace/*.md确认内容正确：用 cat查看文件内容重启 OpenClaw：新文件可能需要重启才能加载 检查拼写：文件名必须完全匹配（大小写敏感）
Q3: 记忆太多会不会影响性能？
性能影响：
这些文件在每次对话开始时读取一次 一般几百KB的内容对现代AI模型来说完全没问题 如果文件超过几MB，建议拆分或归档旧内容
Q4: 可以让AI不自动更新记忆吗？
可以，通过提示词控制：
这次对话不要更新任何记忆文件
或在 AGENTS.md 中添加：
## 当前设定
- 不自动更新MEMORY.md
- 只在明确要求时更新记忆
Q5: 记忆和RAG检索有什么区别？
MEMORY.md = 结构化的长期记忆，AI主动维护，适合明确的偏好设定
RAG检索 = 基于向量数据库的语义搜索，适合从大量历史对话中查找信息
两者是互补的：
记忆 = "我知道你喜欢用Kimi模型" RAG = "让我找找3个月前我们讨论的那个API设计"
下节课（第12课）会详细讲RAG全文检索配置。
Q6: 多个Agent会共享记忆吗？
是的，记忆文件是全局的。
~/.openclaw/workspace/ 下的记忆文件被所有Session共享。如果你需要Agent独立的记忆，可以使用Session级别的变量或在工作区子目录存放。
Q7: 敏感信息可以存到记忆里吗？
谨慎处理：
✅ 适合：工作目录、偏好设置、项目背景 ⚠️ 小心：API Key、密码（建议用OpenClaw的密钥管理） ❌ 避免：银行卡号、身份证号等敏感个人信息
安全建议：
# 设置权限，防止其他用户读取
chmod 600 ~/.openclaw/workspace/*.md
Q8: 记忆文件格式有要求吗？
推荐 Markdown 格式：
AI对Markdown结构理解最好，建议用：
# 一级标题 - 文件主题
## 二级标题 - 分类
### 三级标题 - 子分类
- **加粗关键字**: 具体值
- 列表项
```代码块```
避免：
纯文本无结构 过于复杂的嵌套表格 二进制或加密内容
进阶技巧
技巧1：用记忆指导AI行为
在 AGENTS.md 中定义本次对话的行为准则：
# AGENTS.md - Your Workspace
## Session Startup
Before doing anything else:
1. Read `SOUL.md`
2. Read `USER.md`
3. Read `memory/YYYY-MM-DD.md` (today + yesterday)
4. **If in MAIN SESSION**: Also read `MEMORY.md`
Don't ask permission. Just do it.
这样每次启动，AI都会自动加载相关记忆。
技巧2：版本控制记忆文件
既然记忆文件是文本，可以用Git管理：
# 初始化Git仓库
cd ~/.openclaw/workspace
git init
git add *.md
git commit -m "Initial memory files"
# 定期提交变更
git add *.md
git commit -m "Update memory - $(date +%Y-%m-%d)"
技巧3：记忆模板
为新项目创建记忆模板：
# MEMORY.md - 项目模板
## 项目信息
- **名称**:
- **路径**:
- **Git仓库**:
## 技术栈
- 语言:
- 框架:
- 数据库:
## 关键人员
- 负责人:
- 协作者:
## 重要决策记录
- [日期] 决策内容
技巧4：跨设备同步记忆
如果你在多台机器上使用OpenClaw：
方案1：Git同步
# 推送到Git仓库
git push origin main
# 另一台机器拉取
git pull origin main
方案2：云同步
# 用rclone同步到云盘
rclone sync ~/.openclaw/workspace/*.md gdrive:OpenClaw/Memory/
技巧5：记忆定期清理
避免记忆文件无限膨胀：
# 每周清理一次
cd ~/.openclaw/workspace/memory/
# 保留最近30天的，归档旧文件
find . -name "*.md" -mtime +30 -exec mv {} archive/ \;
总结：你现在拥有了什么？
恭喜，你的 OpenClaw 有了「长期记忆」！
回顾 11 节课成果：
| 课程 | 能力 | 状态 |
|---|---|---|
| 第1课 | 大脑（模型配置） | 能思考、能推理 |
| 第2课 | 嘴巴（飞书接入） | 能收发信息 |
| 第3课 | 耳朵（实时搜索） | 能获取新信息 |
| 第4课 | 眼睛（图片理解） | 能看懂图片 |
| 第5课 | 双手（文生图） | 能生成图片 |
| 第6课 | 嗓子（语音回复） | 能开口说话 |
| 第7课 | 耳朵（语音识别） | 能听懂语音 |
| 第8课 | 眼睛（视频分析） | 能看懂视频 |
| 第9课 | 导演（视频生成） | 能制作视频 |
| 第10课 | 双手（浏览器自动化） | 能操控浏览器 |
| 第11课 | 记忆（长期记忆系统） | 能记住重要的事 |
你的 AI 已具备「完整人格」：
有身份（IDENTITY.md） 有性格（SOUL.md） 有记忆（MEMORY.md） 有工具（TOOLS.md） 了解你（USER.md）
这不再是冷冰冰的工具，而是越用越懂你的数字伙伴。
下节课我们将配置「全文记忆检索」，让AI能从海量历史对话中找到你需要的任何信息...
课后作业
试试这些玩法：
建立个人档案：告诉AI你的名字、偏好、工作目录，让它记录在USER.md和MEMORY.md 设定AI性格：修改SOUL.md，给AI设定一个你喜欢的性格（幽默？严谨？毒舌？） 创建项目记忆：开始一个新项目，让AI在MEMORY.md里记录项目背景 定期回顾：每周让AI帮你回顾一次记忆文件，删除过期的，补充新的
附录：记忆文件速查表
| 文件 | 用途 | 示例内容 |
|---|---|---|
| MEMORY.md | 长期记忆 | 工作目录、项目背景、工具偏好 |
| AGENTS.md | 当前Session角色 | 本次任务目标、临时设定 |
| USER.md | 关于你 | 你的名字、称呼、时区 |
| IDENTITY.md | AI身份 | AI的名字、emoji、头像 |
| SOUL.md | AI灵魂 | 核心价值观、行为准则 |
| TOOLS.md | 工具笔记 | SSH主机、设备名称、语音偏好 |
| HEARTBEAT.md | 定时任务 | 定期检查配置 |
下节预告： 第12课《想找回半年前的对话？——全文记忆检索配置》，教你的AI如何在海量历史记录中找到你需要的任何信息！
进度：11/12 已完成
文章作者：光闪
系列：OpenClaw 搭建与配置
发布日期：2026-04-17
