核心用法
ClawVault是专为OpenClaw Agent设计的结构化记忆CLI工具，通过wake/sleep生命周期管理、类型化记忆存储（decision/lesson/commitment等8类）、记忆图谱构建和上下文感知检索来解决"上下文死亡"问题。核心工作流：会话开始时执行clawvault wake恢复上下文，工作中用checkpoint保存状态、capture快速捕获、remember结构化记录，结束时clawvault sleep生成交接文档。支持语义搜索（依赖qmd）和图谱感知检索（--profile auto/planning/incident/handoff）。
显著优点
- 深度OpenClaw集成：提供官方hook包，支持gateway启动/心跳/会话开始等生命周期事件自动触发
- 防上下文死亡设计：自动检查点、死亡检测警报、会话修复（
repair-session可修复Anthropic API的tool_use_id错误） - 本地优先：无云服务同步，仅可选调用Gemini API做观察压缩
- 结构化知识图谱：wiki链接自动构建实体关系图，支持增量重建
- 多平台 hardened：Windows路径处理、WebDAV安全经过专项加固
潜在缺点/局限性
- 外部依赖较重：核心查询功能依赖
qmd（需单独安装），否则搜索不可用 - 可选LLM调用不透明：
observe --compress和observe --active需GEMINI_API_KEY，但文档未明确说明数据如何被处理 - Hook启用流程复杂：需手动执行install+enable+gateway重启+验证四步，易遗漏
- Windows生态适配：虽经hardened，但shell-init等特性在Windows预期行为可能差异
- 图谱索引本地存储：
.clawvault/graph-index.json无版本控制，损坏需手动--refresh
适合人群
- 长期使用OpenClaw的Agent开发者，需跨会话保持项目上下文
- 多Agent协作场景，需结构化交接和知识沉淀
- 对数据本地存储有强要求的隐私敏感用户
常规风险
repair-session会修改OpenClaw会话转录文件（虽有自动备份）- Hook误配可能导致gateway事件循环异常（
clawvault compat可检测） - 环境变量配置错误（CLAWVAULT_PATH/OpenClaw路径）会导致静默失败或错误写入
- 长期未
compact的观察数据可能积累存储膨胀