什么是ClawVault
ClawVault 是一个专为 OpenClaw 智能体设计的结构化记忆系统，其核心理念源自‘大象永不遗忘’——通过本地化的知识图谱和上下文感知机制，帮助 AI 代理在复杂任务中保持长期记忆与状态连续性。该系统不依赖云端同步或外部网络服务（除可选的 LLM API 调用外），所有数据均存储于用户本地目录中，确保隐私与安全。ClawVault 通过命令行工具提供完整功能集，包括会话恢复、记忆捕获、检查点保存及语义搜索等能力，并深度集成 OpenClaw 的生命周期钩子，实现自动化的上下文注入与状态管理。它采用模块化设计，支持自定义配置文件和模板，适用于需要持续学习、跨会话协作的智能代理场景。 该工具的核心价值在于解决‘上下文死亡’问题——即 AI 代理在长时间运行或中断后丢失工作状态的问题。通过 `wake` 命令启动新会话时，ClawVault 会自动加载最近一次的手写交接记录、活跃项目进展和待办事项；而在使用 `sleep` 结束会话前，可明确标注下一步行动与阻塞项，形成闭环的工作流。此外，系统内置多种记忆类型（如决策、教训、人际关系）和结构化文件夹体系，鼓励用户以标准化方式归档信息，从而构建可追溯的知识资产。无论是开发调试、产品规划还是应急响应，ClawVault 都能显著提升代理的操作连贯性与决策质量。 值得一提的是，ClawVault 强调透明性与可控性：所有操作均可审计，hook 脚本公开可查，且支持手动干预修复损坏的会话日志。对于高级用户，它还提供了基于 Gemini 的观察压缩功能（`observe –compress`），可将原始对话转录提炼为高维度的语义摘要，进一步优化检索效率。尽管依赖 qmd 库进行全文索引，但整体架构轻量、响应迅速，适合嵌入自动化工作流而不引入额外开销。
核心功能特点
- 基于图谱的记忆管理系统，支持 wiki-link 自动关联与语义搜索
- 完整的会话生命周期管理：wake（唤醒）、checkpoint（检查点）、sleep（休眠）、handoff（交接）
- 多维度上下文检索，支持按任务类型动态调整上下文范围（如 incident/planning/handoff 模式）
- 结构化记忆分类存储（决策、教训、关系、项目等），便于长期知识沉淀
- 与 OpenClaw 深度集成，通过钩子机制自动注入上下文并同步状态
- 本地优先的数据安全模型，无云依赖，仅在使用 observe 功能时调用 LLM API
适用场景
ClawVault 特别适用于需要长时间运行、频繁中断又需快速恢复上下文的智能代理场景。例如，在一个持续数小时甚至数天的代码审查或架构设计任务中，代理可在每完成一个关键模块后执行 `clawvault checkpoint` 保存当前进度，并在下次启动时通过 `wake` 重新加载工作焦点与阻塞项，避免重复劳动。对于多轮迭代的产品规划场景，利用 `–profile planning` 获取战略层面的历史决策与资源分配记录，有助于生成更具一致性的路线图建议。当遇到突发故障排查（production outage）时，切换到 `incident` 上下文模式能快速调取近期事件、错误日志与临时解决方案，加速根因分析。 在企业级 AI 协作环境中，ClawVault 可作为团队记忆的共享基础设施。不同代理可在同一 vault 目录下独立运作，但共享统一的知识图谱与上下文池，从而实现跨代理的知识传递与协同决策。例如，前端代理将用户反馈存入 `inbox`，后端代理读取后转化为技术债务条目并链接至对应 issue，整个过程无需人工中转，极大提升了组织级的认知效率。此外，结合 `repair-session` 工具，系统还能自动修复因 API 异常导致的会话断裂问题，保障自动化流程的鲁棒性。 对于个人开发者或研究员而言，ClawVault 同样具备强大价值。无论是追踪实验假设、记录调试心得，还是维护客户联系人数据库，都可以通过标准化的 `remember` 命令持久化关键洞察。配合定期执行的 `graph –refresh` 和 `doctor` 健康检查，用户可以像管理笔记软件一样掌控自己的数字思维资产，而不再担心重要信息随会话结束而消失。这种‘记忆外置化’的设计哲学，让 AI 真正成为可扩展的认知延伸工具。