Versatly / clawvault · v3.0 · npm

La mémoire
qui ne s'efface pas.

ClawVault est la memory-plane du ClawFamily. Markdown comme primitive de stockage, graph-aware, local-first, session-resilient. Résout la "context death" — le problème fondamental de tous les agents AI.

Stars426
Âge38 jours
Versionv3.0
Tests466
LanguageTypeScript
LicenseMIT · npm clawvault
Position dans l'écosystème

ClawFamily — stack complète

Trois couches autour d'OpenClaw. Paperclip au-dessus (contrôle), MetaClaw en dessous (apprentissage), ClawVault sur le côté (mémoire persistante).

Control-plane ↑
Paperclip
Org charts · goal ancestry · budgets · multi-agent · 14K stars / 7j
orchestrates
Agent
OpenClaw
L'agent — exécute les tâches, utilise les outils
hooks into
Memory-plane ↔ — ClawVault
ClawVault
Vault · graph · lifecycle · search hybride · Obsidian
proxied by
Learning-plane ↓
MetaClaw
Intercept · score · train · hot-swap LoRA
trains on
Modèle
Kimi-2.5 + LoRA
En amélioration continue

Paperclip

Qui fait quoi. Coordination, budgets, gouvernance multi-agent.

ClawVault — focus

Ce dont l'agent se souvient. Toutes les décisions, leçons, tâches, handoffs — persistants entre sessions.

MetaClaw

Comment l'agent s'améliore. LoRA cloud, skill evolution, scoring.

Complémentarité

Ils se stackent. ClawVault comme mémoire sous chaque agent que Paperclip orchestre, amélioré par MetaClaw.

Architecture

Session → Observe → Score → Route → Store → Reflect → Promote

Session Lifecycle

clawvault wake
Charge le contexte de la dernière session
→
checkpoint
Sauvegarde l'état en cours (mid-session)
→
remember · capture · inject
Stocke décisions, captures rapides, injecte contexte
→
reflect · session-recap
Génère des leçons depuis la session
→
clawvault sleep
Handoff propre vers session suivante

Structure du vault

Markdown-native · git-friendly · lisible par humains · Obsidian-compatible

decisions/
Choix clés avec raisonnement
lessons/
Insights et patterns appris
people/
Un fichier par personne
projects/
Suivi des travaux actifs
tasks/
Tasks avec frontmatter
backlog/
Captures rapides et idées
handoffs/
Continuité inter-sessions
.clawvault/
graph-index.json · checkpoint · config

MEMORY.md

Boot context — résumé exécutif vu immédiatement par l'agent au démarrage. Identité, décisions clés, focus actuel. Court, dense.

Vault

Full knowledge store — searchable, structured, versioned. Contient tout. MEMORY.md ⊂ Vault. Mise à jour périodique, pas mirroring.

v3.0 — Structured Memory

Fact Store

Extraction de faits structurés à l'écriture. Conflits résolus, dédupliqués. Préférences, attributs, relations.

Entity Graph + Hybrid Search

Requêtes multi-hop. BM25 + semantic embeddings + Reciprocal Rank Fusion (RRF). Le search le plus complet du ClawFamily.

Framework conceptuel

Les 8 Primitives

Comment les agents devraient interagir avec la mémoire persistante. Chaque primitive map à des commandes CLI concrètes.

01 — Goals
Objectifs
tasks/ · projects/ · --working-on
02 — Agents
Identité & ownership
--owner · handoffs
03 — State Space
Contexte & environnement
checkpoint · recover · session state
04 — Feedback
Apprentissage des résultats
lessons/ · observations/ · reflect
05 — Capital
Ressources & contraintes
Token budgets · context profiles · priority
06 — Institution
Règles & patterns
decisions/ · preferences/ · inject
07 — Synthesis
Combinaison d'infos
graph traversal · context blending · search
08 — Recursion
Auto-amélioration
reflect · weekly promotion · archival

Context Profiles

default
Retrieval équilibré
planning
Contexte stratégique large
incident
Événements récents, blockers, urgents
handoff
Transition de session
auto
Sélectionné par hooks selon l'intent
Head-to-head

ClawVault vs Paperclip vs MetaClaw

Dimension Paperclip MetaClaw ClawVault
Layer Control-plane (au-dessus) Learning-plane (en dessous) Memory-plane (sur le côté)
Problème Coordination chaos Stagnation agent Context death
Stars 14 091en 7 jours 74en 1 jour 426en 38 jours
Language TypeScript Python TypeScript
Maturité v0.3.0, prod-ready Research, 1 jour v3.0, 466 tests
Storage PostgreSQL / PGlite Tinker LoRA cloud Fichiers Markdown
Search Non Non BM25 + embeddings + RRF
Concurrent CrewAI, LangGraph, n8n RLHF pipelines offline Mem0, Zep, MEMORY.md statique
Red flag Bus factor 1 Tinker dependency $CLAW token sur pump.fun
Pertinence pour Lyra

Ce que ClawVault valide (et ce que Lyra peut emprunter)

MEMORY.md vs Vault — déjà fait
ClawVault valide exactement le split que Lyra utilise déjà : MEMORY.md = boot context, memory.db = full store. Architecture confirmée.
Hybrid search (BM25 + embeddings + RRF)
2ndBrain fait déjà BM25 + sqlite-vec. ClawVault ajoute RRF — à évaluer dans knowledge/memory.db pour améliorer le ranking.
Les 8 primitives — audit framework
Excellent framework pour auditer la complétude de l'architecture mémoire de Lyra. Quelle primitive manque ? (Recursion / Synthesis sont faibles.)
Context profiles (incident / planning / handoff)
Lyra n'a pas encore de profils de retrieval contextuels. À implémenter : détecter l'intent de la session et ajuster le retrieval en conséquence.
wake / sleep / handoff lifecycle
Lyra a des sessions JSONL mais pas de handoff structuré avec intent + next steps. ClawVault montre le pattern concret à copier.
Fichiers Markdown comme storage
Lyra utilise SQLite — meilleur pour le volume et la recherche sémantique. Pas à changer. Mais les catégories de dossiers sont inspirantes.
Obsidian / Tailscale / WebDAV
Hors scope Lyra. Lyra est un assistant conversationnel, pas un PKM. Pas d'intégration directe utile.
Reflection engine → leçons explicites
2ndBrain compacte déjà. ClawVault ajoute la génération de leçons structurées après chaque session → mémoire procédurale Lyra niveau 5.
Risques

Ce qui peut poser problème

$CLAW token (pump.fun)
Haut
Memecoin associé au projet. Signal fort de dérive spéculative — peut détourner les priorités du développement et nuire à la crédibilité.
qmd dependency
Haut
Installé depuis GitHub (pas npmjs). Auteur unique (tobi). Si qmd disparaît, toute la couche search/context casse sans fallback documenté.
Markdown à l'échelle
Moyen
Performance dégradée avec des milliers de fichiers. SQLite serait plus robuste pour un usage intensif en production.
Verdict

Le projet le plus mature du ClawFamily (v3.0, 466 tests, 38 jours). Les 8 primitives et le lifecycle wake/sleep/handoff sont directement empruntables par Lyra sans changer d'infrastructure. Red flag : le $CLAW token et la dépendance à qmd sont à surveiller.