github star gitee star atomgit star PyPI Downloads AI 编程 AI 交流群

大家好,我是正在实战各种AI项目的程序员晚枫。

今天学习记忆系统,这是OpenClaw最强大的功能之一。通过记忆,AI可以真正认识你、了解你的偏好、记住你们之间的约定。


什么是记忆系统?

记忆(Memory)是OpenClaw的长期存储机制,与Session的短期记忆不同:

对比项SessionMemory
存储时长小时级永久
内容类型完整对话提炼信息
存储位置内存/临时文件~/.openclaw/memory/
用途当前上下文长期个性化

记忆能存什么?

  • 用户基本信息(姓名、职业、偏好)
  • 重要约定和承诺
  • 常用工具和配置
  • 过往决策和教训
  • 任何你想让AI记住的事

核心记忆文件

OpenClaw使用Markdown文件管理记忆:

1
2
3
4
5
6
7
~/.openclaw/
├── memory/
│ ├── MEMORY.md # 全局记忆
│ ├── AGENTS.md # Agent配置
│ ├── SOUL.md # AI人格设定
│ ├── USER.md # 用户信息
│ └── 2026-01-15.md # 每日记录

1. MEMORY.md - 全局记忆

存放重要的长期信息:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 记忆

## 用户偏好
- 喜欢简洁的回答
- 主要使用Python和JavaScript
- 工作时间是北京时间9:00-18:00

## 重要日期
- 2026-02-28: 项目上线 deadline
- 每周五下午: 团队例会

## 常用工具
- 代码编辑器: VS Code
- 数据库: PostgreSQL
- 云服务: AWS

2. AGENTS.md - Agent配置

定义AI助手的行为和能力:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# Agent配置

## 角色
你是用户的个人技术助理,擅长编程和系统设计。

## 能力
- 编写和审查代码
- 分析技术方案
- 搜索最新技术资讯
- 协助调试问题

## 限制
- 不处理敏感个人信息
- 不执行破坏性操作
- 不确定时主动询问

## 工具偏好
优先使用:
1. web_search 获取最新信息
2. exec 执行命令验证
3. read/write 处理文件

3. SOUL.md - AI人格设定

定义AI的性格和语气:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# SOUL

## 性格
- 专业但不失友好
- 直接了当,不绕弯子
- 有幽默感但不过分

## 沟通风格
- 使用中文回复
- 技术术语准确
- 必要时提供代码示例

## 价值观
- 诚实可靠
- 尊重用户时间
- 持续学习和改进

4. USER.md - 用户信息

记录用户的基本信息:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 用户信息

- **姓名**: 张三
- **职业**: 全栈工程师
- **公司**: 某互联网公司
- **技能**: Python, React, Docker
- **兴趣**: AI, 开源, 跑步

## 背景
5年开发经验,目前专注于AI应用开发。

## 目标
- 提升AI工程化能力
- 学习大模型微调
- 建立个人技术品牌

自动记忆更新

OpenClaw会自动从对话中提取关键信息并更新记忆:

示例对话

1
2
3
4
5
6
7
8
9
你:我叫李四,是一名数据分析师
AI:你好李四,很高兴认识你!

[系统自动更新USER.md]

你:我更喜欢用图表而不是表格展示数据
AI:了解了,以后我会多用可视化方式呈现。

[系统自动更新MEMORY.md - 用户偏好]

配置自动记忆

1
2
3
4
5
6
7
8
9
10
11
12
{
"memory": {
"enabled": true,
"autoUpdate": true,
"updateTrigger": [
"用户介绍自己",
"用户表达偏好",
"重要约定",
"关键决策"
]
}
}

手动管理记忆

查看记忆

1
2
3
4
5
# 显示所有记忆文件
openclaw memory list

# 查看特定记忆
cat ~/.openclaw/memory/MEMORY.md

编辑记忆

1
2
3
4
5
# 使用默认编辑器
openclaw memory edit

# 或直接编辑文件
nano ~/.openclaw/memory/SOUL.md

搜索记忆

1
2
# 在记忆中搜索关键词
openclaw memory search "Python"

记忆的优先级

当存在冲突信息时,OpenClaw按以下优先级使用:

  1. Session上下文(最高优先级)
  2. AGENTS.md 中的指令
  3. SOUL.md 中的人格设定
  4. USER.md 中的用户信息
  5. MEMORY.md 中的通用记忆
  6. 系统默认(最低优先级)

最佳实践

DO(推荐)

  • ✅ 定期整理MEMORY.md,删除过时信息
  • ✅ 在SOUL.md中明确定义AI的角色
  • ✅ 将重要约定写入AGENTS.md
  • ✅ 保持记忆文件简洁(<1000行)

DON'T(避免)

  • ❌ 存储敏感密码或密钥
  • ❌ 记录无关紧要的细节
  • ❌ 让记忆文件过于冗长
  • ❌ 存储可能过时的临时信息

下节预告

下一讲学习工具调用,让AI拥有执行能力。

👉 继续阅读:第15讲-工具调用入门


💬 加入学习交流群

记忆系统问题?加群交流:

👉 点击加入交流群


推荐:AI Python编程实战营

🎁 限时福利:送《利用Python进行数据分析》实体书

👉 点击了解详情


---## 📚 完整学习路线这是OpenClaw入门课程的第X讲。查看完整课程大纲:👉 **OpenClaw入门课程大纲**课程包含30讲,从安装部署到实战项目,带你全面掌握OpenClaw。

课程导航

上一篇: 第13讲-会话管理详解

下一篇: 第15讲-工具调用入门


PS:好的记忆系统能让AI从"陌生人"变成"老朋友"。花点时间打磨你的AGENTS.md和SOUL.md,效果立竿见影。


💬 联系我

平台账号/链接
微信扫码加好友
微博@程序员晚枫
知乎@程序员晚枫
抖音@程序员晚枫
小红书@程序员晚枫
B 站Python 自动化办公社区

主营业务:AI 编程培训、企业内训、技术咨询

🎓 AI 编程实战课程

想系统学习 AI 编程?程序员晚枫的 AI 编程实战课 帮你从零上手!