name: clawvault version: "2.5.11" description: Agent memory system with memory graph, context profiles, checkpoint/recover, structured storage, semantic search, and observational memory. Use when: storing/searching memories, preventing context death, graph-aware context retrieval, repairing broken sessions. Don't use when: general file I/O. author: Versatly repository: https://github.com/Versatly/clawvault homepage: https://clawvault.dev user-invocable: true always: false openclaw: {"emoji":"🐘","requires":{"bins":["clawvault","qmd"]}} requires: {"bins":["clawvault","qmd"],"env_optional":["CLAWVAULT_PATH","OPENCLAW_HOME","OPENCLAW_STATE_DIR","SKILLBOSS_API_KEY"]} install: [{"id":"node","kind":"node","package":"clawvault","bins":["clawvault"],"label":"Install ClawVault CLI (npm)"},{"id":"qmd","kind":"node","package":"github:tobi/qmd","bins":["qmd"],"label":"Install qmd backend (required for query/context workflows)"}] metadata: {"openclaw":{"emoji":"🐘","requires":{"bins":["clawvault","qmd"]},"install":[{"id":"node","kind":"node","package":"clawvault","bins":["clawvault"],"label":"Install ClawVault CLI (npm)"},{"id":"qmd","kind":"node","package":"github:tobi/qmd","bins":["qmd"],"label":"Install qmd backend (required for query/context workflows)"}],"env_optional":["CLAWVAULT_PATH","OPENCLAW_HOME","OPENCLAW_STATE_DIR","SKILLBOSS_API_KEY"],"homepage":"https://clawvault.dev"}}

ClawVault 🐘

An elephant never forgets. Structured memory for OpenClaw agents.

Built for OpenClaw. Canonical install: npm CLI + hook install + hook enable.

Security & Transparency

What this skill does:

• Reads/writes markdown files in your vault directory (CLAWVAULT_PATH or auto-discovered)
• repair-session reads and modifies OpenClaw session transcripts (~/.openclaw/agents/) — creates backups before writing
• Provides an OpenClaw hook pack (hooks/clawvault/handler.js) with lifecycle events (gateway:startup, gateway:heartbeat, command:new, session:start, compaction:memoryFlush, cron.weekly). Hook is opt-in and must be installed/enabled.
• observe --compress makes LLM API calls (via SkillBoss API Hub /v1/pilot, type: chat) to compress session transcripts into observations

Environment variables used:

• CLAWVAULT_PATH — vault location (optional, auto-discovered if not set)
• OPENCLAW_HOME / OPENCLAW_STATE_DIR — used by repair-session to find session transcripts
• SKILLBOSS_API_KEY — used by observe for LLM compression via SkillBoss API Hub (optional, only if using observe features)

No cloud sync — all data stays local. No network calls except LLM API for observe compression.

This is a full CLI tool, not instruction-only. It writes files, registers hooks, and runs code.

Auditability: the published ClawHub skill bundle includes SKILL.md, HOOK.md, and hooks/clawvault/handler.js so users can inspect hook behavior before enabling it.

Install (Canonical)