核心用法
ClawVault 是专为 OpenClaw 代理设计的结构化记忆系统，通过 CLI 工具实现会话连续性管理。核心工作流围绕 Wake → Work → Sleep 循环：
clawvault wake：会话启动时恢复上下文，加载近期交接记录、活跃项目和待办承诺clawvault checkpoint：每 10-15 分钟创建检查点，记录当前任务、专注点和阻塞项clawvault sleep：会话结束时生成交接文档，标注下一步行动和阻碍因素clawvault remember：按类型（decision/lesson/relationship 等）存储结构化记忆clawvault context：基于语义搜索 + 图谱邻居检索智能上下文，支持 planning/incident/handoff 等场景配置
技术架构：本地 Markdown 文件存储（无云同步），构建版本化的图索引 .clawvault/graph-index.json，依赖 qmd 实现语义搜索，可选 Gemini API 进行会话压缩。
显著优点
1. 上下文死亡免疫：通过 checkpoint/recover/handoff 机制，彻底解决 AI 会话重启后的"失忆"问题
2. 图谱感知检索：wiki-link 自动构建知识图谱，支持基于图结构的关联记忆召回
3. OpenClaw 原生集成：提供 hook 包接入网关生命周期（startup/heartbeat/session 事件），实现自动化观察与周度反思
4. 会话修复能力：独有的 repair-session 命令可修复 Anthropic API 报错的损坏会话转录（orphaned tool_result 等）
5. 审计透明：hook 源码随 bundle 分发，用户可审查后再启用；所有数据本地驻留
潜在局限
- 依赖链复杂：必须安装 qmd（Node/bun）才能使用核心查询功能，增加了维护负担
- LLM 可选依赖：observe --compress 等功能需要 GEMINI_API_KEY，否则功能降级
- OpenClaw 生态锁定：hook 机制专为 OpenClaw 设计，其他 Agent 框架无法直接复用
- 手动习惯养成：checkpoint/sleep 等需用户主动执行，自动化程度受限于 hook 配置
- Windows 兼容性：虽经强化，但跨平台路径处理（WebDAV/qmd URI 规范化）仍存在边缘 case
适合人群
- 长期使用 OpenClaw 进行复杂多会话项目的开发者
- 需要维护跨会话项目连续性的 AI 辅助工作流用户
- 对数据本地驻留有强偏好、拒绝云同步的隐私敏感用户
- 愿意投入 setup 成本换取长期记忆可靠性的进阶用户
常规风险
- 文件系统操作风险：
repair-session会直接修改 OpenClaw 会话转录（虽自动备份），误操作可能导致会话历史损坏 - hook 过度自动化：heartbeat 触发的观察与压缩可能在后台消耗 Gemini API 额度
- 图索引膨胀：长期运行后
.clawvault/graph-index.json可能体积膨胀，影响检索性能 - qmd 供应链风险：依赖 GitHub 非 npm 发布的 qmd 包，更新和审计链条较弱