Agent记忆永不丢失的智能管家

OpenClaw生态的记忆系统，通过结构化存储、语义搜索和上下文恢复解决Agent"失忆"问题，数据本地存储保障隐私安全。

基本信息

• 技能名称?clawvault
• 中文名称?Agent记忆永不丢失的智能管家
• 作者?G9Pedro
• 分类?其他
• 版本?未标注
• 标签?productivity, automation, development-engineering, data-analytics, backend

使用方法

使用说明
核心用法
ClawVault 是专为 OpenClaw Agent 设计的记忆管理系统，通过 CLI 工具 clawvault 实现结构化记忆存储与上下文连续性保障。核心工作流围绕 Wake-Capture-Sleep 循环展开：会话开始时执行 clawvault wake 恢复上下文，工作中使用 clawvault capture 快速记录或 clawvault checkpoint 保存状态，结束时 clawvault sleep 生成交接文档。记忆按类型（fact/feeling/decision/lesson/commitment/preference/relationship/project）分类存储，支持语义搜索（需 qmd）和基于 wiki-link 的知识图谱构建。
显著优点

1. 上下文死亡免疫 ：自动检测上下文丢失并提供恢复机制，通过 hook 在 gateway:startup 和 command:new 事件触发时自动检查点
2. 图谱感知检索 ：构建类型化知识图谱（ .clawvault/graph-index.json ），支持多维度上下文配置（default/planning/incident/handoff）
3. 会话修复能力 ：独有的 repair-session 功能可修复 Anthropic API 报错导致的损坏会话转录文件，自动备份保障安全
4. 零信任网络设计 ：除可选的 observe --compress 功能外，所有数据本地存储，无云端同步或遥测
5. OpenClaw 原生集成 ：通过可选 hook 实现自动上下文注入，支持 clawvault compat 诊断集成健康度
   潜在缺点与局限性
6. 外部依赖 ：语义搜索依赖 qmd 工具（需单独安装），功能降级时仅支持关键词搜索
7. Gemini API 可选依赖 ： observe --compress 需要配置 GEMINI_API_KEY ，增加密钥管理负担
8. 学习曲线 ：记忆类型系统、wiki-link 规范、上下文配置等概念需要一定上手时间
9. Node.js 生态锁定 ：基于 npm 分发，对非 Node 环境用户不够友好
10. 存储膨胀风险 ：长期高频使用可能导致 vault 目录体积增长，需定期归档
    适合的目标群体
    长期运行的 OpenClaw Agent ：需要跨会话保持上下文的复杂任务代理
    多项目并行开发者 ：通过知识图谱管理技术决策、人员关系、项目状态
    研究型工作流 ：需要追溯决策理由、经验教训的知识工作者
    团队协作场景 ：通过标准化 handoff 文档实现 Agent 间工作交接
    使用风险
11. 文件系统风险 ： repair-session 会修改 ~/.openclaw/agents// 下的会话文件，虽有自动备份，仍建议在关键操作前手动备份
12. 环境变量配置 ： CLAWVAULT_PATH 等路径配置错误可能导致 vault 无法定位，建议通过 clawvault shell-init 固化配置
13. hook 启用风险 ：自动检查点功能在极端高频场景下可能产生性能开销，可通过 openclaw hooks disable clawvault 临时禁用
14. qmd 版本兼容性 ：语义搜索功能依赖 qmd 的特定版本，升级时需注意兼容性测试