ClawVault 记忆库
把 Agent 会话中的决策、教训、人物和项目存成带图谱的本地 markdown 记忆库,会话断了或压缩后能接回来。
功能与用途
长时间干活的 Agent 一旦上下文被压缩或会话中断,之前定过的技术选型、踩过的坑、跟谁对接过就全忘了,得重新问一遍。ClawVault 让 Agent 把记忆按类型写进本地一个 vault 目录,再用 wiki-link 和标签把这些条目连成知识图谱,检索时可以顺着图找邻居,也可以语义搜索。每次开工先 wake 把上下文捞回来,干活中间 checkpoint,收工 sleep 留下下一步和卡点。它全部落本地、不云同步,但要先在 Node 环境装好 clawvault 和 qmd 两个命令行工具,hook 也需要手动装并启用。
适用场景
- 一次长任务做到一半会话断了,第二天要接着做,但已经想不起来上:一次长任务做到一半会话断了,第二天要接着做,但已经想不起来上次选了什么方案、为什么这么选
- 上下文被压缩后 Agent 忘了前面定过的技术决策,又开始建:上下文被压缩后 Agent 忘了前面定过的技术决策,又开始建议另一套做法,需要有个地方能把它捞回来
- 团队里好几个人和同一个 Agent 协作,希望关于某个人、某:团队里好几个人和同一个 Agent 协作,希望关于某个人、某个项目的来龙去脉能跨会话留下来
- 想把每次技术选型的理由和踩过的坑沉淀下来,以后检索时能顺着相:想把每次技术选型的理由和踩过的坑沉淀下来,以后检索时能顺着相关条目一起看到
- 想让 Agent 在会话启动、心跳、上下文压缩这些时机自动存:想让 Agent 在会话启动、心跳、上下文压缩这些时机自动存一次进度,不用每次手动提醒
适用人群
- 长期跑 AI Agent 做项目的开发者
- 搭建 OpenClaw 工作流的自动化工程师
- 被上下文压缩反复打断的技术团队
使用步骤
- 先在 Node 环境里装好 clawvault 命令和 qmd 查询后端,用 clawvault init 建一个 vault 目录或指向已有的
- 开工时跑一次 wake,把上次的交接、活跃项目和待办承诺恢复到上下文里
- 干活过程中把关键决策、教训、人物、项目按类型存进去,重要节点跑一次 checkpoint
- 需要历史信息时用关键词或语义检索,或按 planning/incident/handoff 等档位取一段上下文
- 收工前跑 sleep 记下在做什么、下一步和卡点;想让这些自动发生就再装并启用 OpenClaw hook
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- AI工作流
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- 2.5.13
- 最近更新
- 2026-05-11
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Agent memory system with memory graph, context profiles, checkpoint/recover, structured storage, semantic search, observational memory, task tracking, canvas...
使用前准备
- 需要 Node/npm 环境并全局安装 clawvault 与 qmd 两个命令行工具
- 用 hook 还要装 OpenClaw CLI 并重启 gateway
- observe 压缩功能需配置 GEMINI_API_KEY
依赖与权限
- CLAWVAULT_PATH
- GEMINI_API_KEY
- 读取用户主动提供的内容