什么是Memory Manager
Memory Manager 是专为 OpenClaw 工作流设计的记忆维护工具，其核心理念是在不替换现有记忆架构的前提下，对长期记忆与日常笔记进行安全、可控的管理。它服务于 OpenClaw 原生记忆模型，即通过 `MEMORY.md` 管理经过筛选的长期记忆，以 `memory/YYYY-MM-DD.md` 格式保存每日工作日志，并利用 `memory_search` 和 `memory_get` 等内置命令实现检索功能。该工具严格遵循“不迁移记忆结构、不随意移动每日文件、不将关键词搜索伪装为语义理解”的原则，确保记忆系统的稳定性和可回溯性。所有操作均以保护原始数据完整性为前提，避免因自动化处理导致不可逆的信息丢失。 Memory Manager 提供了一套完整的 PowerShell 脚本集，涵盖健康检查、快照创建、内容审查、索引诊断与归档等多个维度。这些脚本不仅支持快速状态概览（如检查今日文件是否存在、近期笔记数量、快照备份情况），还能在语义搜索失效时自动降级为关键词匹配，并明确标注所用模式，提升透明度。特别适用于在重大变更前建立记忆快照，或在故障排查期间恢复上下文环境。此外，工具强调‘只读优先’策略——当已有文件存在时，优先采用追加或侧边文件的方式，而非覆盖原有内容，从而最大限度降低误操作风险。 该工具的设计哲学体现在多个层面：一是尊重现有工作流，所有脚本均围绕 OpenClaw 原生接口构建；二是强调可审计性，每个操作都保留执行路径与结果记录；三是具备自愈能力，`doctor.ps1` 可在检测到索引异常或提供者问题时尝试修复。同时，通过 `-Workspace` 参数支持跨平台部署，尽管主要面向 Windows 环境开发，但已考虑路径抽象以提升可移植性。整体而言，Memory Manager 并非替代方案，而是强化现有记忆基础设施的守护者，帮助用户在复杂项目演进中维持认知连续性。
核心功能特点
- 在不破坏现有记忆结构的前提下进行内存维护，兼容 OpenClaw 原生记忆模型
- 提供多维度健康检查机制，包括文件状态、索引就绪度与提供者连接性诊断
- 支持创建预操作快照，为高风险重构或配置变更提供安全回滚点
- 智能搜索策略：优先使用语义搜索，失败时透明降级至关键词匹配并标明模式
- 自动化归档旧日笔记，按时间阈值安全移出主目录而不干扰当前工作流
- 所有操作遵循最小干预原则，避免覆盖已有文件，倡导追加或侧边文件策略
适用场景
Memory Manager 最典型的应用场景是在执行可能影响记忆系统稳定性的关键操作之前建立保护屏障。例如，在进行大规模代码重构、切换嵌入模型提供者、调整索引策略或启动长时间会话前，用户可通过运行 `snapshot.ps1` 生成一个包含当前所有记忆文件的完整快照。这一机制确保即使后续操作引发意外后果，也能迅速恢复到操作前的完整上下文状态，特别适合团队协作环境中需要频繁调整技术栈的情况。 另一个高频使用场景是记忆系统的故障排查与恢复。当遇到 `memory_search` 无响应、嵌入向量生成失败或 SQLite 数据库锁定时，`doctor.ps1` 脚本能够自动检测问题根源——可能是网络中断导致的提供者不可用，也可能是索引损坏。用户只需添加 `-Repair` 参数即可触发自动修复流程，极大降低了手动调试的认知负担。对于独立开发者而言，这种自助式诊断能力显著提升了记忆系统的鲁棒性。 在日常工作中，Memory Manager 同样扮演着知识沉淀助手的角色。通过定期运行 `review.ps1 -Days 7`，用户可以从最近七天的每日笔记中提取重复出现的主题、决策模式或临时结论，并生成结构化摘要草稿。这些内容可被人工审核后导入 `MEMORY.md`，形成可长期引用的经验资产。这种机制尤其适合需要持续积累领域知识的研发岗位，有效防止短期记忆随时间衰减。 此外，随着项目周期推进，`memory/` 文件夹中的每日笔记会不断累积，占用存储空间并影响检索效率。此时可使用 `archive.ps1 -KeepDays 30` 将超过指定天数的旧笔记移至归档区，既保持主目录整洁，又保留历史可追溯性。该功能结合 `check.ps1` 的状态报告，让用户清晰掌握记忆库的健康状况与资源分布，实现从被动维护到主动治理的转变。