memory-sync

Memory Sync 是一款专为 OpenClaw 用户设计的记忆连续性维护工具，通过解析本地 JSONL 会话日志，智能重建和回填 Agent 记忆文件，有效解决模型切换或系统异常导致的记忆断层问题。

核心用法
该工具提供双轨制工作流：compare 命令可快速检测会话日志与记忆文件的覆盖缺口；backfill 命令支持从简单提取到 LLM narrative 摘要的两种模式。简单提取模式基于关键词频率分析和文本模式识别，无需外部 API 即可快速生成结构化记忆；LLM 模式则通过 OpenClaw 原生后端或第三方 API（Anthropic/OpenAI）生成连贯的叙事摘要。配合 --incremental 和 --today 参数，用户可设置 cron 定时任务实现每日凌晨自动同步，而 --preserve 标志能确保人工批注在重新生成时被智能合并而非简单追加。

显著优点
最突出的安全特性是深度敏感信息脱敏机制，内置 30 余种显式模式（涵盖 OpenAI、AWS、Stripe 等主流服务密钥）及 JWT、SSH 密钥、数据库连接字符串等结构检测，在提取、处理、写入、展示全流程实施红码替换。默认使用 openclaw 后端进行摘要生成，无需额外配置 API 密钥，显著降低使用门槛。内容保留策略在 LLM 模式下会将现有手工笔记作为上下文传入模型，实现真正的语义融合而非机械拼接。

潜在局限
作为 T3 级个人开源项目，长期维护稳定性依赖单一开发者，建议用户关注社区反馈。依赖版本尚未通过 requirements.txt 完全锁定，可能存在版本漂移风险。功能深度绑定 OpenClaw 生态，非该框架用户无法使用。LLM 模式虽默认使用本地配置，但若选用第三方后端将产生 API 调用成本。

目标群体
主要面向 OpenClaw 重度使用者、需要保障 Agent 长期记忆连续性的专业开发者、以及运营多模型切换环境的自动化运维人员。特别适合对会话隐私有严格要求且希望实现"黑盒化"记忆管理的团队。

使用风险
工具需要读取 ~/.openclaw/agents/ 下的会话日志并写入工作区记忆目录，涉及本地文件系统敏感权限。尽管具备完善的秘密清理机制，用户仍需定期抽查生成文件确保无敏感信息泄露。自动化部署时应注意日志轮转和磁盘空间管理，避免长期累积的会话数据占用过多存储。