ClawVault 🐘

为 AI Agent 提供的持久化内存系统

大象从不遗忘。你的 AI 也不应遗忘。

文档 · npm 包 · Obsidian 插件 · GitHub

---

什么是 ClawVault？

ClawVault 是一个为 AI Agent 设计的结构化内存系统，它以 Markdown 作为存储基元。它解决了 AI Agent 在会话间丢失上下文这一核心问题——我们将其称为“上下文死亡”（context death）。

与向量数据库或基于云的内存解决方案不同，ClawVault 具有以下特点：

• 本地优先 (Local-first) — 数据始终保留在你的机器上。无云同步，无供应商锁定。
• 原生 Markdown (Markdown-native) — 易于人类阅读，对 git 友好，开箱即用支持 Obsidian。
• 图感知 (Graph-aware) — 通过 Wiki 链接构建知识图谱，丰富上下文检索效果。
• 会话弹性 (Session-resilient) — 检查点/恢复（Checkpoint/recover）基元可确保在崩溃或上下文重置后数据依然可用。
• 事实感知 (Fact-aware) — 在写入时进行抽取，构建带有冲突解决机制的结构化事实。

┌─────────────────────────────────────────────────────────────────────────────┐
│                           ClawVault 架构                                     │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│   ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐             │
│   │  Agent   │───▶│  Session │───▶│ Observer │───▶│  Router  │             │
│   │ (Claude, │    │ Watcher  │    │Compressor│    │          │             │
│   │  GPT..)  │    └──────────┘    └──────────┘    └────┬─────┘             │
│   └──────────┘                                         │                    │
│        │                                               ▼                    │
│        │         ┌─────────────────────────────────────────────────────┐   │
│        │         │                  Markdown Vault                      │   │
│        │         │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐  │   │
│        │         │  │decisions/│ │ lessons/ │ │ people/  │ │projects│  │   │
│        │         │  └──────────┘ └──────────┘ └──────────┘ └────────┘  │   │
│        │         │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐  │   │
│        │         │  │ tasks/   │ │ backlog/ │ │handoffs/ │ │ inbox/ │  │   │
│        │         │  └──────────┘ └──────────┘ └──────────┘ └────────┘  │   │
│        │         └─────────────────────────────────────────────────────┘   │
│        │                                    │                               │
│        │         ┌──────────────────────────┴──────────────────────────┐   │
│        │         │              .clawvault/ (内部状态)                  │   │
│        │         │  graph-index.json │ last-checkpoint.json │ config   │   │
│        │         └─────────────────────────────────────────────────────┘   │
│        │                                    │                               │
│        ▼                                    ▼                               │
│   ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐             │
│   │  wake    │◀──▶│ context  │◀──▶│  Graph   │◀──▶│  Search  │             │
│   │  sleep   │    │ profiles │    │ Traversal│    │(hybrid)  │             │
│   │checkpoint│    └──────────┘    └──────────┘    └──────────┘             │
│   └──────────┘                                                              │
│                                                                             │
│   数据流：会话 → 观察 → 评分 → 路由 → 存储 → 反思 → 提升                      │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

---

8 大基元

ClawVault 基于 8 个核心基元构建，这些基元模拟了 Agent 应如何与持久化内存进行交互：

基元	描述	ClawVault 实现
目标 (Goals)	Agent 试图实现的目标	tasks/, projects/, --working-on 标志
代理 (Agents)	身份和所有权追踪	--owner 元数据，Agent 移交
状态空间 (State Space)	当前上下文和环境	checkpoint, recover, 会话状态
反馈 (Feedback)	从结果中学习