核心用法
ClawVault 是专为 OpenClaw 智能体打造的全功能记忆管理系统，采用「图谱+语义」双引擎架构。核心工作流围绕 Wake → Work → Sleep 周期设计：会话开始时执行 clawvault wake 自动恢复上下文；工作中通过 checkpoint 高频保存状态、用 capture 快速捕获灵感、remember 分类存储决策/教训/关系等结构化记忆；会话结束执行 clawvault sleep 生成交接文档，实现跨会话连续性。
系统内置 Graph-Aware Context Retrieval，通过 wiki 链接、标签和 frontmatter 构建增量知识图谱（.clawvault/graph-index.json），支持语义搜索（vsearch）与图谱邻居检索。提供 planning/incident/handoff/auto 四种上下文配置画像，适配不同场景的智能检索需求。
显著优点
1. 上下文死亡免疫：自动检测会话断裂、注入恢复提示、修复损坏的 OpenClaw 会话转录（repair-session）
2. 零云依赖：纯本地 Markdown 存储，无网络调用（除可选的 Gemini API 用于观测压缩）
3. OpenClaw 原生集成：通过 Hook 包实现生命周期事件监听（startup/heartbeat/session:start 等），支持自动画像切换与观测刷新
4. 企业级可审计：Hook 源码随技能分发，用户可审查后再启用；所有文件操作带备份机制
5. 跨平台加固：v2.5.8 针对 Windows 路径处理、WebDAV 安全、URI 规范化进行专项加固
潜在局限与风险
- 硬依赖 qmd：核心查询/语义搜索 workflow 依赖
github:tobi/qmd，该包未在 npm 官方注册，存在供应链风险 - Hook 启用门槛：需要手动执行
hooks install → 审查源码 → hooks enable → 重启 gateway四步流程，新手易出错 - LLM 调用可选但隐蔽：
observe --compress/--active会调用 Gemini Flash，需显式配置GEMINI_API_KEY，但文档分散易被忽略 - 无原生加密：vault 目录以明文 Markdown 存储，敏感记忆需用户自行加密卷管理
- 图谱规模瓶颈：
graph-index.json为单文件 JSON，大型知识库可能遇到加载性能问题
适合人群
- 长期运行的 OpenClaw/Claude Code 智能体用户，受困于上下文窗口限制或会话重启失忆
- 需要结构化追踪决策脉络、客户关系、项目演进的知识工作者
- 对数据主权敏感、拒绝云同步的隐私优先用户
- 具备 Node.js/npm 生态 familiarity、能接受命令行工作流的技术用户
常规风险
- 供应链攻击向量：
qmd从 GitHub 直接安装，建议锁定 commit hash 或 vendoring - 误操作覆盖：
repair-session会修改~/.openclaw/agents/下文件，虽有自动备份，仍建议在版本控制环境中使用 - Hook 事件泛滥：heartbeat 触发的高频观测可能产生大量记忆碎片，需配合
compaction:memoryFlush定期整理 - Gemini API 泄露：若启用观测压缩，API key 以环境变量传递，存在进程泄露风险