memory-system

# Memory System 🧠 > 完整记忆系统 - 四类记忆分类 + AutoDream 自动整合 + MiniMax LLM 驱动 + Feedback 双向记录 **版本**: 2.0.0 | **作者**: 团宝 (openclaw) --- ## 核心特性 | 特性 | 说明 | |------|------| | 📁 **文件系统存储** | 纯 Markdown，无数据库，可直接编辑 | | 🔍 **语义搜索** | Ollama 向量搜索 + 关键词降级 | | ⚡ **自动加载** | 会话启动时自动读取相关记忆 | | 📝 **四类记忆** | User / Feedback / Project / Reference | | 🔄 **Feedback 双向** | 纠正 (negative) + 确认 (positive) | | 🌙 **AutoDream** | 定时自动整合，MiniMax LLM 驱动 | | 💾 **智能 Flush** | 上下文接近阈值时自动保存 | --- ## AutoDream：自动记忆整合 ### 工作原理 ``` 定时触发 (每天 22:00) 或 手动触发 ↓ 扫描所有记忆文件 + 会话历史 ↓ 调用 MiniMax LLM 分析 ↓ 自动执行整合： - 新增遗漏的记忆 - 删除过时的记忆 - 更新 MEMORY.md 索引 ↓ 通知用户整合结果 ``` ### 触发条件 | 条件 | 默认值 | 说明 | |------|--------|------| | 时间间隔 | ≥ 24 小时 | 距离上次整合的时间 | | 新会话数 | ≥ 3 个 | 新增的会话数 | ### 整合能力 - ✅ 扫描现有记忆文件 - ✅ 识别过时信息 - ✅ 合并重复记忆 - ✅ 更新 MEMORY.md 索引 - ✅ 使用绝对日期 - ✅ 四类记忆分类 --- ## 四类记忆分类 ### 1. User（用户）记忆 **作用域**: 私密 **用途**: 了解用户角色、偏好、知识背景 ```markdown ## user/李明.md - 民盟上海市委宣传部副部长 - 技术背景：AI、编程 - 偏好：简洁回复，中文为主 ``` ### 2. Feedback（反馈）记忆 ⭐ **作用域**: 私密 / 团队 **用途**: 记录用户的纠正和确认 ```markdown ## feedback/开发规范.md ### 集成测试必须用真实数据库 **Type:** negative **Why:** 上季度mock测试通过但生产迁移失败 **How to apply:** 禁止在集成测试中 mock 数据库层 **Date:** 2026-03-15 ### 单PR优于多个小PR **Type:** positive **Why:** 拆分反而造成不必要的开销 **How to apply:** 重构类需求优先合并为大PR **Date:** 2026-03-20 ``` ### 3. Project（项目）记忆 **作用域**: 团队 **用途**: 项目进展、目标、决策 ```markdown ## project/民盟宣传系统.md - 阶段：二期开发 - 目标：6月底前完成 - 当前：AI播客监控系统 ``` ### 4. Reference（引用）记忆 **作用域**: 团队 **用途**: 外部系统入口 ```markdown ## reference/工具入口.md - Bug追踪：Linear 项目 "MINMENG" - 文档：Confluence /minmeng-space ``` --- ## 安装 ```bash clawhub install memory-system ``` --- ## 工具列表 ### memory_search 语义搜索记忆 ```json { "query": "用户对代码规范的偏好", "type": "feedback", "topK": 5 } ``` ### memory_write 写入记忆（写入后自动检查是否触发 AutoDream） ```json { "file": "feedback/dev-rules.md", "content": "### 集成测试...\n**Type:** negative...", "type": "feedback", "mode": "append" } ``` ### memory_flush 手动触发持久化 ```json { "force": true } ``` ### memory_dream 执行 AutoDream 整合 ```json { "force": false } ``` - `force: false` - 检查条件，满足后执行 - `force: true` - 强制立即执行 ### memory_dream_status 查看整合状态 ```json {} ``` 返回： ```json { "enabled": true, "lastDream": "2026-03-30T22:00:00Z", "hoursSince": 21.5, "sessionsSinceLast": 5, "totalMemoryFiles": 32, "nextTrigger": "已达时间条件" } ``` --- ## 配置 ```json { "skills": { "memory-system": { "memoryDir": "~/.openclaw/workspace/memory", "flushMode": "safeguard", "softThresholdTokens": 300000, "vectorEnabled": true, "embeddingModel": "nomic-embed-text", "autoDream": { "enabled": true, "minHours": 24, "minSessions": 3, "apiKey": "env:MINIMAX_CODING_API_KEY" } } } } ``` --- ## 目录结构 ``` memory/ ├── MEMORY.md # 索引文件 ├── .auto-dream-state.json # 整合状态 ├── user/ # 用户记忆 │ └── [用户ID].md ├── feedback/ # 反馈记忆 │ ├── positive/ # 正面确认 │ └── negative/ # 纠正指导 ├── project/ # 项目记忆 │ └── [项目名].md ├── reference/ # 引用记忆 │ └── external.md └── sessions/ # 会话历史 └── [日期].json ``` --- ## 与 HEARTBEAT 集成 AutoDream 与 OpenClaw HEARTBEAT 深度集成： ```markdown ## 🌙 AutoDream 记忆整合 (每天 22:00) - 自动检查触发条件 - 静默执行，无变化时通知 - 手动触发：说"执行记忆整合" ``` --- ## 最佳实践 ### 保存时机 | 类型 | 保存时机 | 示例 | |------|---------|------| | User | 了解用户信息 | "我是数据科学家" | | Feedback | 用户纠正/确认 | "不要那样做" / "perfect" | | Project | 了解项目动态 | "在做X项目" | | Reference | 发现外部资源 | "bug在Linear跟踪" | ### 格式规范 ```markdown ### [标题] **Type:** negative | positive **Why:** [原因] **How to apply:** [何时应用] **Date:** YYYY-MM-DD ``` ### 索引规范 - 每条索引 <= 150 字符 - 使用绝对日期 - 按 user / feedback / project / reference 分类 --- ## 技术架构 ``` memory-system (v2.0.0) ├── src/ │ ├── index.ts # 入口 + 工具注册 │ ├── search.ts # 向量/关键词搜索 │ ├── write.ts # 写入 + 触发检查 │ ├── get.ts # 读取 │ ├── flush.ts # 内存持久化 │ ├── autoLoad.ts # 自动加载 │ ├── embed.ts # 向量嵌入 │ └── autoDream.ts # AutoDream LLM整合 └── HEARTBEAT.md # 定时触发集成 ``` --- **版本**: 2.0.0 | **更新**: AutoDream 与记忆系统深度整合