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 格式存储，虽便于人工阅读，但大规模使用时建议定期归档历史文件以维持检索性能。

核心用法

Claw Memory Guardian 是一款专为 OpenClaw 生态设计的记忆持久化 Skill，通过五级防护机制解决 AI 助手"失忆"顽疾。核心工作流程为：

初始化阶段：memory-guardian init 自动创建 ~/.openclaw/workspace/memory/ 目录结构，包含长期记忆文件 MEMORY.md、每日日志 YYYY-MM-DD.md、索引文件 memory_index.json 及项目时间线 project_timeline.json。

实时防护：会话开始时自动加载当日记忆；关键决策点更新 MEMORY.md；任务完成时同步时间线；会话结束自动生成摘要。支持 300 秒间隔自动保存与 1800 秒 Git 自动提交，形成完整版本链。

语义检索：memory-guardian search "上周讨论的项目计划" 支持自然语言查询、时间范围过滤（--date）及标签检索（--tag），快速定位历史上下文。

崩溃恢复：异常终止检测 → 状态恢复 → 进度提示 → 继续建议，四步闭环确保中断无忧。

显著优点

1. 痛点精准：源于开发者 2026 年 2 月真实"失忆"教训，产品化思路清晰，直击 OpenClaw 用户核心痛点
2. 架构完整：文件系统 + Git 版本控制 + JSON 索引三层设计，兼顾可靠性、可追溯性与检索效率
3. 零外部依赖：纯本地运行，无 API 调用，数据不出境，隐私风险极低
4. 渐进增强：免费版覆盖基础需求，专业版/企业版叠加语义搜索、团队协作、API 访问等增值功能
5. 生态契合：深度绑定 OpenClaw 工作流，clawdhub install 一键安装，降低使用门槛

潜在局限

1. 存储膨胀风险：每日日志自动累积，长期运行可能导致磁盘占用增长，需依赖用户手动清理或配置保留策略
2. Git 依赖局限：版本控制依赖本地 Git，若用户未安装 Git 或工作目录非 Git 仓库，核心功能降级为纯文件备份
3. 语义搜索精度：基于关键词匹配而非向量嵌入，复杂语义关联场景下召回率可能不足
4. 协作冲突：团队版虽承诺"合并冲突解决"，但缺乏具体算法说明，多人并发编辑同一记忆文件时存在覆盖风险
5. 商业化绑定：企业级功能（API 访问、定制开发）定价 $99/月，对小团队可能构成门槛

适合人群

• 个人用户：长期项目跟进者、知识工作者，需跨会话保持上下文连贯
• 团队用户：研发、产品、咨询等需共享决策历史的协作场景
• Skill 开发者：OpenClaw 生态建设者，需维护复杂多文件项目的开发状态
• 合规敏感型用户：数据必须本地存储，拒绝云端同步的企业环境

常规风险

• 文件权限风险：默认写入 ~/.openclaw/workspace，若该路径权限配置不当可能导致写入失败或数据泄露
• 敏感信息残留：MEMORY.md 可能累积含机密内容的对话摘要，需用户主动审计清理
• 版本回滚误操作：restore --force 强制恢复可能覆盖未保存的新进度
• 存储介质故障：纯本地架构意味着无云端灾备，硬盘损坏将导致记忆永久丢失

安全认证解读

CLS-Certify v2.1.0 全扫描报告（CLS-2026-0516-CMG-001）显示：评分 85/A 级，标准安全级别。六维检测中静态分析 88 分、动态分析 85 分、依赖审计 90 分表现优异。唯一低风险项为 test.js 使用 child_process.execSync 进行测试目录清理，属可控测试代码；生产代码无危险函数。依赖 simple-git、fs-extra 等均为成熟开源库，无已知 CVE。网络维度 95 分满分，零外部 API 调用，数据零出境。

关键结论：功能实现与声明一致，代码结构清晰，无明显安全风险，适合生产环境部署，但建议用户定期备份记忆目录至异地存储。