claw-memory-guardian

Claw Memory Guardian 是一款专为 OpenClaw 生态设计的记忆持久化工具，旨在解决 AI 助手会话"失忆"的行业痛点。该 Skill 通过建立本地化的记忆管理系统，为用户提供从实时保存到崩溃恢复的全链路保护。

核心用法围绕五个关键命令展开：通过 memory-guardian init 初始化记忆目录结构，自动创建 MEMORY.md 长期记忆文件和每日工作日志；memory-guardian save 实现重要节点的即时持久化并自动触发 Git 提交；memory-guardian search 支持基于语义的本地内容检索，可按时间范围和标签筛选；memory-guardian backup 创建独立目录的完整备份；memory-guardian restore 则在异常中断后恢复工作状态。系统默认每 30 分钟自动 Git 提交，每 5 分钟自动保存草稿，形成多层防护。

显著优点体现在其纯本地化的安全架构设计。与云端记忆方案不同，所有数据仅存储于 ~/.openclaw/workspace 目录，杜绝隐私泄露风险。自动版本控制基于 simple-git 实现，支持历史回滚和变更追溯。语义搜索功能通过本地索引快速定位历史决策和项目进度，避免信息分散。崩溃恢复机制能检测异常终止并提示中断前的工作上下文，显著降低任务重复成本。

潜在局限性主要包括环境依赖和存储成本。系统要求预装 Node.js ≥14.0.0 和 Git 环境，在部分容器化或受限环境中可能受限。自动备份策略虽默认保留 7 天，但高频操作可能产生较大磁盘占用，需手动调整 backupRetention 配置。此外，当前版本不支持跨设备同步，团队协作需手动处理记忆合并冲突。

适合目标群体包括长期依赖 OpenClaw 进行复杂项目开发的工程师、需要维持多会话上下文的产品经理，以及重视数据隐私不愿使用云端记忆的企业用户。对于频繁遭遇 exec 命令被 KILL 导致进度丢失的开发者，该工具能节省 50% 以上的重复工作时间。

使用风险主要涉及存储管理和 Git 配置。建议定期运行 memory-guardian health 检查磁盘占用，避免备份膨胀。由于依赖 Git 进行版本控制，若本地 Git 配置不当（如用户信息缺失）可能导致自动提交失败。此外，记忆文件以 Markdown 和 JSON 格式存储，虽便于人工阅读，但大规模使用时建议定期归档历史文件以维持检索性能。