Auto Memory - 自动记忆更新 v1.3.0
让你的 agent 拥有完整持久记忆系统,自动管理学习经验。
v1.3.0 完整功能
| 功能 | 说明 |
|---|---|
| 🧹 自动过期清理 | 归档 30 天前的日志 |
| 🎯 优先级过滤 | 只加载 critical/high 学习 |
| 🌐 跨 Agent 共享 | 共享错误和最佳实践 |
| 📝 智能摘要 | 自动提取关键词摘要 |
| 🔄 增量索引 | 只索引变更文件 |
| 📊 定期提炼 | 每周日提炼长期记忆 |
安装
# 创建目录
mkdir -p ~/.openclaw/scripts
mkdir -p ~/.openclaw/workspace/.learnings/shared
# 下载脚本
# 从 Gitee 克隆或下载
# 初始化所有 agent
for agent in main python-expert architect product-manager operations-assistant data-analyst; do
dir="$HOME/.openclaw/workspaces/$agent"
[ "$agent" = "main" ] && dir="$HOME/.openclaw/workspace"
mkdir -p "$dir/memory" "$dir/.learnings" "$dir/.openclaw"
done
文件结构
~/.openclaw/workspaces/<agent>/
├── AGENTS.md
├── MEMORY.md
├── memory/
│ ├── YYYY-MM-DD.md # 日常日志
│ └── archive/ # 过期归档
├── .learnings/
│ ├── LEARNINGS.md # 学习经验
│ ├── ERRORS.md # 错误记录
│ └── archive/ # 已解决归档
└── .openclaw/
└── .index-state.json # 索引状态
~/.openclaw/workspace/.learnings/shared/
├── common-errors.md # 共享错误
└── best-practices.md # 共享最佳实践
工作流程
┌─────────────────────────────────────────────────────────┐
│ Session 开始 │
└────────────────────────┬────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────────┐
│ 1. 自动清理 │
│ - 归档 30 天前的 memory 日志 │
│ - 归档已解决的错误 │
└────────────────────────┬────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────────┐
│ 2. 加载学习经验 │
│ - LEARNINGS.md (priority: critical/high) │
│ - ERRORS.md (priority: critical/high) │
│ - shared/common-errors.md │
│ - shared/best-practices.md │
└────────────────────────┬────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────────┐
│ 3. 提取 session 对话 │
│ - 检测重要对话 → memory/ │
│ - 检测错误 → ERRORS.md │
│ - 检测纠正 → LEARNINGS.md │
│ - 检测最佳实践 → shared/best-practices.md │
│ - 生成智能摘要(关键词提取) │
└────────────────────────┬────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────────┐
│ 4. 增量索引 │
│ - 检查文件变更 │
│ - 只在有变更时重建索引 │
└────────────────────────┬────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────────┐
│ 5. 周报提炼(每周日) │
│ - 提炼项目、关键词、决策 │
│ - 更新 MEMORY.md │
└─────────────────────────────────────────────────────────┘
自动检测规则
错误 → ERRORS.md
关键词:错误、失败、报错、error、failed、exception、bug、崩溃
纠正 → LEARNINGS.md
关键词:不对、错了、应该、其实、实际上、不是
最佳实践 → shared/best-practices.md
关键词:最佳、推荐、建议、最好、优化
共享错误 → shared/common-errors.md
包含 API、网络、配置、权限 的错误
配置 Heartbeat
## 1. 自动记忆更新
\`\`\`bash
~/.openclaw/scripts/extract-memory.sh AGENT_ID
\`\`\`
配置 AGENTS.md
## 每次会话开始时
1. 读取 `MEMORY.md` — 长期记忆
2. 读取 `memory/YYYY-MM-DD.md` — 近期对话
3. 读取 `.learnings/LEARNINGS.md` — 历史学习
4. 读取 `.learnings/ERRORS.md` — 历史错误
5. 读取 `.learnings/shared/` — 共享经验
示例输出
🧹 检查过期文件...
📦 已归档 3 个过期日志
📚 加载学习经验...
⚠️ 学习经验: 2 条高优先级
🔴 错误记录: 1 条高优先级
🌐 共享错误: 5 条
💡 共享最佳实践: 8 条
📄 分析 session: 2c36a403-xxx.jsonl
✅ 已更新 memory: 12 条消息
📝 摘要: 记忆系统, 优化, 提取
🔄 更新向量索引...
✅ 索引已更新
配置参数
DAYS_TO_KEEP=30 # 日志保留天数
更新日志
v1.3.0 (2026-03-12)
- 📝 智能摘要(关键词提取)
- 🔄 增量索引(只索引变更)
- 📊 定期提炼(每周日)
v1.2.0 (2026-03-12)
- 🧹 自动过期清理
- 🎯 优先级过滤
- 🌐 跨 Agent 共享
v1.1.0 (2026-03-12)
- 整合 self-improvement
- 主动加载历史学习
v1.0.0 (2026-03-12)
- 初始版本