OpenClaw 记忆系统指南

记忆系统概述

OpenClaw 的记忆系统采用极简设计哲学：简单到极致。

设计理念

无向量数据库：不需要复杂的 RAG 管道
无 Embedding 索引：不需要向量搜索
纯 Markdown 文件：AI 的记忆就是磁盘上的文本文件
可读可编辑：随时查看和修改 AI 的记忆
可版本控制：可以用 Git 追踪记忆变化

记忆架构

~/.openclaw/workspace/
├── MEMORY.md              # 长期记忆（精选的重要信息）
└── memory/
    ├── 2026-04-30.md      # 今天的日志
    ├── 2026-04-29.md      # 昨天的日志
    └── ...                # 更早的日志

两层记忆架构

长期记忆（MEMORY.md）

用途：

存储你的偏好和习惯
记录重要决策
保存关键事实
记住常用信息

加载时机：

每次会话启动时自动加载
始终在 AI 的上下文中

示例内容：

# 用户偏好

## 个人信息
- 姓名：张三
- 职业：软件工程师
- 时区：Asia/Shanghai
- 语言偏好：中文

## 工作习惯
- 工作时间：9:00-18:00
- 使用 VS Code 作为主要编辑器
- 偏好 TypeScript 而非 JavaScript
- 代码风格：使用 2 空格缩进

## 项目信息
- 主要项目：LearnAISimply
- 技术栈：Next.js + FastAPI + PostgreSQL
- 代码仓库：github.com/username/project

## 常用命令
- 启动前端：cd frontend && npm run dev
- 启动后端：cd backend && uvicorn app.main:app --reload
- 运行测试：pytest

## 重要提醒
- 每次提交代码前运行测试
- 使用 Conventional Commits 规范
- 定期备份数据库

每日日志（memory/YYYY-MM-DD.md）

用途：

记录当天的对话和决策
临时笔记和待办事项
上下文信息

加载时机：

加载今天和昨天的日志
提供短期上下文

示例内容：

# 2026-04-30

## 上午
- 讨论了新功能的设计方案
- 决定使用 Redis 作为缓存层
- 创建了 3 个新的 API 端点

## 下午
- 修复了登录功能的 bug
- 更新了文档
- 计划明天进行性能测试

## 待办事项
- [ ] 完成用户认证模块
- [ ] 编写单元测试
- [ ] 更新 README

## 重要决策
- 采用 JWT 认证方式
- 使用 PostgreSQL 15+

记忆工具

AI 有两个记忆工具可以使用：

memory_search

语义搜索所有记忆文件。

用法：

AI: 让我搜索一下你之前提到的项目信息...
[调用 memory_search("项目信息")]

memory_get

精确读取特定记忆内容。

用法：

AI: 让我查看你的工作习惯...
[调用 memory_get("工作习惯")]

配置记忆系统

查看记忆配置

# 查看记忆系统状态
openclaw memory status

# 查看记忆文件位置
openclaw config get workspace.path

配置记忆参数

# 配置记忆文件路径
openclaw config set memory.path "~/.openclaw/workspace"

# 配置日志保留天数
openclaw config set memory.retention.days 30

# 配置自动清理
openclaw config set memory.autoCleanup true

管理记忆

查看记忆

# 查看长期记忆
cat ~/.openclaw/workspace/MEMORY.md

# 查看今天的日志
cat ~/.openclaw/workspace/memory/$(date +%Y-%m-%d).md

# 查看所有记忆文件
ls -la ~/.openclaw/workspace/memory/

编辑记忆

# 编辑长期记忆
vim ~/.openclaw/workspace/MEMORY.md

# 编辑今天的日志
vim ~/.openclaw/workspace/memory/$(date +%Y-%m-%d).md

搜索记忆

# 搜索记忆内容
openclaw memory search "项目信息"

# 在所有记忆文件中搜索
grep -r "关键词" ~/.openclaw/workspace/memory/

清理记忆

# 清理旧的日志（保留最近 30 天）
openclaw memory cleanup --days 30

# 手动删除特定日志
rm ~/.openclaw/workspace/memory/2026-01-01.md

让 AI 记住信息

方式一：直接告诉 AI

最简单的方式是直接告诉 AI 你想让它记住什么：

你：请记住，我的工作时间是 9:00-18:00
AI：好的，我已经记住了你的工作时间。

AI 会自动将这些信息写入 MEMORY.md。

方式二：在对话中提及

在对话中自然地提及信息，AI 会判断是否需要记住：

你：我通常使用 VS Code 编写代码
AI：了解，我注意到你使用 VS Code。需要我记住这个偏好吗？
你：是的
AI：已记录。

方式三：手动编辑

直接编辑 MEMORY.md 文件：

vim ~/.openclaw/workspace/MEMORY.md

添加你想让 AI 记住的信息。

记忆最佳实践

1. 结构化组织

使用清晰的标题和分类：

# 用户偏好

## 个人信息
...

## 工作习惯
...

## 项目信息
...

2. 保持简洁

只记录重要信息：

避免冗余
删除过时信息
定期整理

3. 使用列表

便于 AI 快速查找：

## 常用命令
- 启动服务：npm run dev
- 运行测试：npm test
- 构建项目：npm run build

4. 添加上下文

提供足够的上下文信息：

## 项目决策

### 2026-04-30：选择数据库
- 决定：使用 PostgreSQL
- 原因：需要关系型数据库，支持复杂查询
- 备选方案：MySQL（性能略低）

5. 定期审查

定期检查和更新记忆：

# 每周审查一次
openclaw memory review

# 查看记忆统计
openclaw memory stats

6. 版本控制

使用 Git 管理记忆：

cd ~/.openclaw/workspace
git init
git add MEMORY.md memory/
git commit -m "Initial memory"

# 定期提交
git add -A
git commit -m "Update memory"

记忆模板

个人助手模板

# 个人信息
- 姓名：
- 职业：
- 时区：
- 语言：

# 日常习惯
- 工作时间：
- 休息时间：
- 偏好的沟通方式：

# 重要日期
- 生日：
- 纪念日：

# 常用联系人
- 姓名：关系，联系方式

# 待办事项
- [ ] 任务 1
- [ ] 任务 2

开发助手模板

# 开发环境
- 操作系统：
- 编辑器：
- 终端：
- 包管理器：

# 项目信息
- 项目名称：
- 技术栈：
- 代码仓库：
- 部署环境：

# 编码规范
- 代码风格：
- 命名约定：
- 注释规范：

# 常用命令
- 启动开发服务器：
- 运行测试：
- 构建项目：
- 部署：

# 重要决策
- 日期：决策内容

学习助手模板

# 学习目标
- 短期目标：
- 长期目标：

# 学习计划
- 当前学习：
- 已完成：
- 计划学习：

# 知识点
## 主题 1
- 要点 1
- 要点 2

## 主题 2
- 要点 1
- 要点 2

# 学习资源
- 书籍：
- 课程：
- 文档：

# 学习笔记
- 日期：笔记内容

高级功能

记忆分片

将大型记忆文件分片管理：

# 创建分片
mkdir -p ~/.openclaw/workspace/memory/fragments

# 按主题分片
~/.openclaw/workspace/memory/fragments/
├── personal.md
├── work.md
├── projects.md
└── learning.md

记忆导入导出

# 导出记忆
openclaw memory export --output memory-backup.zip

# 导入记忆
openclaw memory import --input memory-backup.zip

记忆同步

在多设备间同步记忆：

# 使用 Git 同步
cd ~/.openclaw/workspace
git remote add origin https://github.com/username/openclaw-memory.git
git push -u origin main

# 在另一台设备上
git clone https://github.com/username/openclaw-memory.git ~/.openclaw/workspace

记忆加密

保护敏感信息：

# 启用加密
openclaw config set memory.encryption.enabled true
openclaw config set memory.encryption.key "YOUR_ENCRYPTION_KEY"

# 加密现有记忆
openclaw memory encrypt

记忆插件

记忆系统是一个插件槽位，可以使用不同的记忆插件。

默认记忆插件

基于 Markdown 文件的简单实现。

向量记忆插件（实验性）

使用 sqlite-vec 实现向量搜索：

# 安装向量记忆插件
openclaw plugins install memory-vector

# 启用插件
openclaw config set memory.plugin "memory-vector"

自定义记忆插件

开发自己的记忆插件：

# 创建插件目录
mkdir -p ~/.openclaw/plugins/my-memory

# 实现插件接口
# - search(query)
# - get(key)
# - set(key, value)
# - delete(key)

常见问题

记忆文件过大

解决方案：

定期清理旧日志
使用记忆分片
压缩历史记忆

# 清理 30 天前的日志
openclaw memory cleanup --days 30

# 压缩历史记忆
openclaw memory archive --before 2026-01-01

AI 记不住信息

原因：

信息未写入 MEMORY.md
记忆文件格式错误
上下文窗口限制

解决方案：

# 检查记忆文件
cat ~/.openclaw/workspace/MEMORY.md

# 手动添加信息
vim ~/.openclaw/workspace/MEMORY.md

# 验证格式
openclaw memory validate

记忆冲突

原因：

多设备同时修改
Git 合并冲突

解决方案：

# 查看冲突
git status

# 手动解决冲突
vim MEMORY.md

# 提交解决
git add MEMORY.md
git commit -m "Resolve memory conflict"

记忆统计

# 查看记忆统计
openclaw memory stats

# 输出示例：
# 长期记忆大小：15.2 KB
# 日志文件数量：30
# 总记忆大小：245.8 KB
# 最早日志：2026-01-01
# 最新日志：2026-04-30

记忆备份

自动备份

# 启用自动备份
openclaw config set memory.backup.enabled true
openclaw config set memory.backup.interval "daily"
openclaw config set memory.backup.path "~/.openclaw/backups"

手动备份

# 创建备份
openclaw memory backup

# 恢复备份
openclaw memory restore --backup 2026-04-30

最佳实践总结

结构化组织：使用清晰的标题和分类
保持简洁：只记录重要信息
定期审查：每周检查和更新
版本控制：使用 Git 管理记忆
备份重要信息：定期备份记忆文件
保护隐私：加密敏感信息
多设备同步：使用 Git 同步
清理旧数据：定期清理过期日志

下一步

掌握记忆系统后，你可以：

多 Agent 配置：阅读多 Agent 协作指南
部署到生产：阅读 Docker 部署指南
加固安全：阅读安全配置指南
性能优化：优化记忆系统性能

参考资源

记忆系统文档：https://docs.openclaw.ai/memory
记忆插件开发：https://docs.openclaw.ai/plugins/memory
最佳实践：https://docs.openclaw.ai/best-practices
社区讨论：https://discord.gg/clawd

OpenClaw 记忆系统指南：让 AI 记住你的偏好

分享这篇文章