Skip to content

OpenClaw 记忆系统

管理和使用 AI 的长期记忆。


🧠 记忆系统架构

记忆类型

类型位置用途保存时间
短期记忆会话中当前对话上下文会话期间
长期记忆MEMORY.md重要信息永久
每日记忆memory/YYYY-MM-DD.md日常记录按需保留
向量记忆memory/main.sqlite语义搜索永久

📁 记忆文件结构

目录结构

~/.openclaw/workspace/
├── MEMORY.md              # 长期记忆
└── memory/
    ├── YYYY-MM-DD.md      # 每日记忆
    └── main.sqlite        # 向量数据库

MEMORY.md 结构

markdown
# 长期记忆

## 用户信息
- 姓名:张三
- 职业:工程师
- 喜好:简洁的回复

## 项目信息
- 项目 A:进行中
- 项目 B:已完成

## 重要决定
- 2026-03-17:选择 OpenClaw 作为 AI 框架

每日记忆结构

markdown
# 2026-03-17

## 完成的工作
- 搭建 AI 知识库网站
- 编写 19 篇教程

## 学习的内容
- OpenClaw 配置方法
- 技能开发流程

## 遇到的问题
- Emoji 显示问题
- 导航配置问题

## 解决方案
- 移除 Emoji,使用纯文字
- 检查配置文件语法

🔧 记忆管理

手动管理

创建记忆

bash
# 创建每日记忆
cat > ~/.openclaw/workspace/memory/2026-03-17.md << 'EOF'
# 2026-03-17

## 重要事件
- 网站上线
- 完成教程编写
EOF

更新长期记忆

bash
# 编辑 MEMORY.md
vim ~/.openclaw/workspace/MEMORY.md

# 添加新内容
echo "## 新记忆" >> ~/.openclaw/workspace/MEMORY.md

自动管理

配置记忆压缩

json
{
  "agents": {
    "defaults": {
      "compaction": {
        "mode": "safeguard",
        "threshold": 100,
        "target": 50
      }
    }
  }
}

记忆清理

bash
# 清理过期记忆
openclaw memory clean --older 30d

# 清理向量数据库
openclaw memory vacuum

🔍 记忆搜索

语义搜索

bash
# 搜索记忆
openclaw memory search "OpenClaw 配置"

# 限制结果数量
openclaw memory search "配置" --limit 5

# 设置最小相似度
openclaw memory search "配置" --min-score 0.7

关键词搜索

bash
# 全文搜索
openclaw memory grep "配置"

# 递归搜索
openclaw memory grep -r "配置" memory/

💡 记忆使用技巧

1. 记录重要信息

markdown
# 在对话中记录
用户说:记住我喜欢简洁的回复

AI 记录到 MEMORY.md:
## 用户偏好
- 回复风格:简洁,不啰嗦

2. 定期回顾

bash
# 每周回顾
cat memory/*.md | grep "## 完成的工作"

# 每月总结
find memory/ -name "*.md" -mtime -30 | xargs cat

3. 记忆提取

javascript
// 在技能中使用记忆
const memory = await context.memory.search('用户偏好');
const style = memory.results[0]?.content;

return generateResponse(style);

📊 记忆优化

1. 记忆分级

markdown
# MEMORY.md(永久保留)
- 用户基本信息
- 重要决定
- 长期项目

# memory/YYYY-MM-DD.md(定期清理)
- 日常工作记录
- 临时信息
- 会议记录

2. 记忆压缩

javascript
// 压缩长记忆
async function compressMemory(memories) {
  const summary = await ai.summarize(memories, {
    maxLength: 500,
    preserve: ['decisions', 'actions']
  });
  
  return summary;
}

3. 记忆关联

markdown
## 项目 A
相关记忆:
- [[2026-03-17]] 项目启动
- [[2026-03-18]] 需求分析
- [[2026-03-19]] 开发完成

🛠️ 向量记忆配置

配置向量数据库

json
{
  "memory": {
    "enabled": true,
    "type": "vector",
    "database": "lancedb",
    "path": "~/.openclaw/memory",
    "maxEntries": 10000,
    "embedding": {
      "model": "bge-large-zh",
      "dimension": 1024
    }
  }
}

优化搜索性能

bash
# 创建索引
openclaw memory index --rebuild

# 优化查询
openclaw memory optimize

📋 记忆管理最佳实践

日常习惯

  • [ ] 每天记录重要事件
  • [ ] 每周回顾整理
  • [ ] 每月清理过期记忆
  • [ ] 定期备份记忆文件

记录原则

  • ✅ 记录决策和原因
  • ✅ 记录用户偏好
  • ✅ 记录项目进展
  • ❌ 不记录敏感信息
  • ❌ 不记录临时信息

组织方法

markdown
# 使用标签
#工作 #项目 A #重要

# 使用链接
参考 [[2026-03-17]] 的讨论

# 使用时间线
2026-03-17: 项目启动
2026-03-18: 需求确认
2026-03-19: 开发开始

🔒 记忆安全

敏感信息处理

bash
# 加密敏感记忆
gpg --symmetric MEMORY.md

# 设置文件权限
chmod 600 ~/.openclaw/workspace/MEMORY.md

隐私保护

markdown
# ❌ 不要记录
- 密码和凭证
- 身份证号
- 银行卡号
- 个人隐私信息

# ✅ 可以记录
- 工作偏好
- 项目信息
- 学习内容
- 公开信息

📈 记忆系统监控

监控指标

bash
# 查看记忆大小
du -sh ~/.openclaw/memory/

# 查看记忆数量
openclaw memory stats

# 查看向量数据库
openclaw memory vector-stats

性能优化

bash
# 定期清理
openclaw memory clean --older 90d

# 优化索引
openclaw memory index --optimize

# 备份记忆
tar -czf memory-backup.tar.gz ~/.openclaw/memory/

提示

好的记忆系统让 AI 更懂你!

🟢🐉 泡泡龙

Released under the MIT License.