ClawVault 核心评估
核心用法
ClawVault 是一款专为 OpenClaw 生态设计的Agent 记忆系统 CLI 工具，提供从会话恢复到知识图谱构建的全套记忆管理能力。核心工作流遵循 wake → checkpoint → sleep 周期：clawvault wake 在会话开始时恢复上下文并生成摘要；clawvault checkpoint 每10-15分钟保存工作状态；clawvault sleep 在会话结束时捕获交接信息。所有记忆以 Markdown 文件形式本地存储，支持八类结构化类型（decision、lesson、relationship 等），并通过 wiki-link 自动构建知识图谱。
搜索能力由语义引擎 qmd 驱动，提供关键词搜索 (clawvault search) 与语义搜索 (clawvault vsearch) 双模式。上下文检索支持五种场景化 Profile（planning、incident、handoff 等），可根据任务类型动态调整召回策略。repair-session 功能可修复 Anthropic API 报错导致的损坏会话转录，自动备份原始文件。
显著优点
1. 上下文死亡免疫：通过 checkpoint/recover/handoff 机制，彻底解决长会话中断后的状态丢失问题
2. 本地优先架构：零云同步，所有数据驻留本地文件系统，隐私可控
3. 知识图谱原生：wiki-link 自动关联生成图索引，支持图感知检索
4. OpenClaw 深度集成：提供官方 hook pack，支持生命周期事件自动触发（启动、心跳、内存压缩等）
5. 可审计透明：hook 源码随 skill 分发，用户需显式 review 后启用
6. 跨平台稳定：449项测试通过，Windows 路径处理已加固
潜在局限
- 外部依赖重：核心搜索功能依赖 qmd（非 npm 官方包，需从 GitHub 安装），安装链路较长
- Gemini 依赖可选但关键：
observe --compress功能需GEMINI_API_KEY，否则无法使用 LLM 压缩能力 - 学习曲线陡峭：八类记忆类型、五种 context profile、hook 生命周期等概念需要用户建立使用习惯
- 修复功能侵入性：
repair-session直接修改 OpenClaw 会话转录，虽自动备份但仍属高风险操作 - 生态锁定：为 OpenClaw 深度优化，脱离该生态后价值显著降低
适合人群
- 长期运行 OpenClaw Agent 的开发者与团队
- 需要维护跨会话项目上下文的复杂工作流用户
- 对数据本地存储有强隐私要求的场景
- 愿意投入时间建立记忆管理纪律的进阶用户
常规风险
- 文件系统风险：CLI 直接读写用户目录文件，误操作可能导致数据覆盖（虽有备份机制）
- Hook 权限风险：启用 hook 后，ClawVault 可响应 OpenClaw 生命周期事件，需信任 hook 源码
- API 密钥泄露：
GEMINI_API_KEY需配置在环境变量，共享环境可能暴露 - 依赖供应链：qmd 从 GitHub 直接安装，缺少 npm 的完整性校验机制