memory-mastery

Memory Mastery 是专为 OpenClaw 智能体设计的跨会话记忆持久化解决方案，采用独特的三层架构（L1 每日日志、L2 长期记忆、L3 向量搜索）解决 Agent 重启后上下文丢失的核心痛点。

核心用法上，用户通过 setup.sh 初始化系统后，Agent 会在每次会话开始时自动读取当日和前一日的日志文件（memory/YYYY-MM-DD.md）以及长期记忆文件（MEMORY.md）。会话过程中，Agent 实时追加记录到每日日志，重要决策则手动整理至长期记忆。每周通过 maintenance.sh 审查近期日志，将关键信息提炼到 L2 层。若启用 memory-core 插件，还可通过语义搜索（L3）快速定位历史上下文。

显著优点体现在其工程设计的严谨性：纯 Bash 脚本实现零外部依赖，避免了供应链攻击风险；自动备份机制（.backup-TIMESTAMP）确保安装过程可逆；隐私保护设计使 MEMORY.md 仅在主会话加载，避免敏感信息泄露；三层架构兼顾了记录的便捷性（L1）、知识的持久性（L2）和检索的智能性（L3）。

潜在缺点主要包括维护成本：L2 层需要人工定期整理，否则会变得陈旧冗余；长期使用的 MEMORY.md 可能膨胀影响 token 消耗；L3 向量搜索依赖外部嵌入 API（如 Voyage）产生额外成本；每日日志积累会占用磁盘空间，需要定期归档。

适合的目标群体为 OpenClaw 的重度用户，特别是需要长期跟踪复杂项目、跨多会话保持决策连贯性的开发者、研究员或知识工作者。对于重视数据隐私、希望完全掌控记忆数据的用户尤为适用。

使用风险方面，虽然脚本内置了完善的安全措施（错误处理 set -euo pipefail、操作前确认、文件备份），但仍需注意：脚本需要对工作区目录的写权限，误操作可能修改 AGENTS.md 等核心配置；备份文件长期积累可能占用磁盘空间；多用户共享工作区时，每日日志可能包含敏感信息，需配合隐私保护策略使用。