OpenClaw 记忆系统重构:突破长对话失忆瓶颈

┌─────────────────────────────────────────────────────────┐│  对话进行中                                              ││  上下文 tokens: 80,000 / 100,000                        │└─────────────────────────────────────────────────────────┘                          ↓┌─────────────────────────────────────────────────────────┐│  达到软阈值 (softThresholdTokens)                        ││  触发 memoryFlush                                        │└─────────────────────────────────────────────────────────┘                          ↓┌─────────────────────────────────────────────────────────┐│  AI 助手执行静默回合（NO_REPLY）                          ││  系统提示："请将重要信息写入记忆文件"                     │└─────────────────────────────────────────────────────────┘                          ↓┌─────────────────────────────────────────────────────────┐│  关键信息固化到：                                        ││  - memory/YYYY-MM-DD.md（短期）                          ││  - MEMORY.md（长期）                                    │└─────────────────────────────────────────────────────────┘                          ↓┌─────────────────────────────────────────────────────────┐│  会话压缩执行                                            ││  关键信息已持久化，压缩不会导致丢失                       │└─────────────────────────────────────────────────────────┘

{  agents: {    defaults: {      compaction: {        memoryFlush: {           // 是否启用（默认：true）          enabled: true,          // 刷新阈值（tokens）          // 当上下文达到此值时触发 memoryFlush          softThresholdTokens: 4000,           // 刷新提示词          prompt: "请检查当前对话，将重要信息写入记忆文件",          // 系统提示（追加）          systemPrompt: `使用 NO_REPLY 标记，不要输出用户可见内容。重点记录：1. 用户的偏好、决策、重要信息2. 待办事项和未完成的任务3. 项目进展和关键上下文`,        },      },    },  },}

# 2026-04-10 聊天日志> 创建日期：2026-04-10 (周五)> 最后更新：2026-04-10 11:54> 状态：active | archived | reviewed---## 重要对话### [11:43] 主题标签- **类型**：咨询 | 决策 | 任务 | 闲聊- **优先级**：high | medium | low- **关联项目**：OpenClaw 配置

日志文件 (YYYY-MM-DD.md)├── 重要对话│   ├── [时间] 主题 1│   └── [时间] 主题 2├── 待办事项│   ├── [ ] 任务 1│   └── [x] 任务 2（已完成）└── 临时笔记    └── 临时信息

{  "date": "2026-04-10",  "entries": [    {      "timestamp": "11:43",      "topic": "Heartbeat 任务配置咨询",      "type": "咨询",      "priority": "medium",      "summary": "用户询问当前 Heartbeat 任务配置",      "output": null,      "tags": ["heartbeat", "配置"]    },    {      "timestamp": "11:48",      "topic": "记忆维护频率调整",      "type": "决策",      "priority": "high",      "summary": "将记忆维护从每周改为每日执行",      "output": "~/.openclaw/workspace/HEARTBEAT.md",      "tags": ["heartbeat", "记忆维护"]    }  ]}

# 提取时间戳grep -oP '\[\d{2}:\d{2}\]' memory/2026-04-10.md# 提取待办事项grep -oP '- \[.\] .*' memory/2026-04-10.md# 提取文件路径grep -oP '`[^`]+`' memory/2026-04-10.md

┌─────────────────────────────────────────────────────────┐│  每日日志 (memory/YYYY-MM-DD.md)                         ││  - 原始对话记录                                          ││  - 临时上下文                                            ││  - 待办事项                                              │└─────────────────────────────────────────────────────────┘                          ↓ 定期提炼┌─────────────────────────────────────────────────────────┐│  长期记忆 (MEMORY.md)                                    ││  - 持久化事实                                            ││  - 用户偏好                                              ││  - 重要决策                                              │└─────────────────────────────────────────────────────────┘

{  agents: {    defaults: {      compaction: {        memoryFlush: {          enabled: true,          // 同时更新短期和长期记忆          prompt: "请将重要信息写入 memory/YYYY-MM-DD.md，\                   将持久化事实提炼到 MEMORY.md",        },      },    },  },}

// HEARTBEAT.md 配置{  // 定期检查（每日 2-4 次）  heartbeat: {    frequency: "2-4 times/day",    tasks: [      "检查聊天内容保存",      "查看 MEMORY.md 更新需求",      "检查待办事项状态",    ],  },  // 记忆维护（每日 1 次）  memoryMaintenance: {    frequency: "daily",    time: "04:00", // 凌晨 4 点    tasks: [      "回顾昨日日志",      "提炼到长期记忆",      "清理过时待办",    ],  },}

# 使用 git 管理记忆文件版本cd ~/.openclaw/workspacegit initgit add MEMORY.md memory/git commit -m "Daily memory update $(date +%Y-%m-%d)"

---## 更新日志- 2026-04-10: 添加记忆维护频率调整决策- 2026-04-09: 初始创建，记录 OpenClaw 配置项目

# 查看历史版本git log MEMORY.md# 回滚到指定版本git checkout <commit-hash> MEMORY.md# 恢复最新版本git checkout HEAD MEMORY.md

# 读取昨日日志cat memory/2026-04-09.md# 识别关键信息模式：# - 用户明确说"请记住..."# - 重要决策和结论# - 项目进展里程碑# - 新发现的偏好

// 压缩前（冗余）MEMORY.md:- 用户喜欢 TypeScript- 用户偏好 TypeScript 而非 JavaScript- 用户说他用 TypeScript 写项目// 压缩后（合并）MEMORY.md:- **编程语言偏好**：TypeScript（主要使用）

# 查找超过 30 天未更新的日志find ~/.openclaw/workspace/memory -name "*.md" -mtime +30# 归档旧日志mkdir -p ~/.openclaw/workspace/memory/archivemv ~/.openclaw/workspace/memory/2026-03-*.md archive/

// ~/.openclaw/openclaw.json{  agents: {    defaults: {      // 记忆搜索配置      memorySearch: {        provider: "openai",        model: "text-embedding-3-small",        // 混合搜索权重        hybrid: {          vectorWeight: 0.7,          keywordWeight: 0.3,        },      },      // 压缩与记忆刷新配置      compaction: {        enabled: true,        reserveTokens: 16384,        keepRecentTokens: 20000,        memoryFlush: {          enabled: true,          softThresholdTokens: 4000,          prompt: "请检查当前对话，将重要信息写入记忆文件",          systemPrompt: "使用 NO_REPLY 标记，静默执行",        },      },      // 沙箱配置（可选）      sandbox: {        mode: "non-main",        workspaceAccess: "none",      },    },  },  // 会话维护配置  session: {    maintenance: {      mode: "enforce",      pruneAfter: "30d",      maxEntries: 500,    },  },}

# HEARTBEAT.md - 心跳任务清单## 定期检查（每日 2-4 次）- [ ] 检查是否有新的聊天内容保存到 `memory/YYYY-MM-DD.md`- [ ] 查看 MEMORY.md 是否需要更新- [ ] 检查待办事项状态## 记忆维护（每日）- [ ] 回顾昨日的 `memory/*.md` 文件- [ ] 提炼重要内容到 MEMORY.md- [ ] 清理过时的待办事项- [ ] 检查是否有冲突信息需要解决## 状态跟踪- 最后检查时间：记录在 `memory/heartbeat-state.json`- 最后提炼时间：记录在 MEMORY.md 更新日志---**响应规则**：- 无事项 → `HEARTBEAT_OK`- 有更新 → 直接回复更新内容

# 每日凌晨 4 点自动执行记忆整理openclaw cron add \  --name "每日记忆整理" \  --schedule "0 4 * * *" \  --timezone "Asia/Shanghai" \  --message "请执行以下任务：    1. 读取昨天的 memory/YYYY-MM-DD.md 文件    2. 识别重要事件、决策、待办事项    3. 更新 MEMORY.md 提炼值得长期保存的内容    4. 检查是否有未完成的待办事项    5. 回复 HEARTBEAT_OK 如果没有需要用户知晓的事项"