ClawVault

Changelog

Release history for ClawVault — every version, every feature, every fix.

Subscribe via RSS

v2.4.4 — February 14, 2026

Added

  • Task State Transition Ledger — every task status change emits a typed JSONL event to ledger/transitions/YYYY-MM-DD.jsonl with task_id, agent_id, from_status, to_status, timestamp, confidence, cost_tokens, and reason.
  • clawvault task transitions [task_id] — query transition history with --agent, --failed, and --json filters.
  • --confidence and --reason flags on task update and task done commands.
  • Regression detection — flags backward transitions (done→open, done→blocked, in-progress→blocked).
  • Auto-escalation — tasks with 3+ blocked transitions automatically get escalation: true in frontmatter.
  • clawvault blocked --escalated — filter for escalated tasks only.

v2.4.3 — February 14, 2026

Changed

  • Updated npm description and keywords to reflect v2.4.x features (context profiles, canvas dashboards, neural themes).

v2.4.2 — February 14, 2026

Fixed

  • --minimal flag now correctly skips tasks, bases, and graph via new initFlags parameter in vault.init() and createVault().
  • --categories flag passes custom category list through to createVault() correctly.
  • --no-bases flag wired through initFlags.skipBases in vault.init().
  • Existing vault detection — init now errors with "A ClawVault already exists" instead of silently overwriting.
  • Welcome note guard — createWelcomeNote() checks this.config.categories.includes('inbox') before writing.
  • Bases guard — createBasesFiles() only runs when this.config.categories.includes('tasks').
  • All init options (--minimal, --categories, --no-bases, --no-tasks, --no-graph, --canvas, --theme, --name) fully wired in CLI registration.

v2.4.1 — February 14, 2026

Changed

  • README rewritten from scratch (~6.5KB) to reflect v2.4.x features.
  • Package metadata updated — new description, keywords for context profiles, canvas dashboards, neural themes.

v2.4.0 — February 14, 2026

Added

  • Brain Architecture Canvas — clawvault canvas --template brain generates a 4-quadrant system overview: Hippocampus (vault structure + content flow), Direction (stats + decisions), Agent Workspace (active/blocked/backlog), and Knowledge Graph (stats + top entities + category bars).
  • Owner-Centric Project Board — clawvault canvas --template project-board redesigned with status columns, priority icons, owner cards (🤖 agents / 👤 humans), and backlog grouped by project.
  • Canvas Customization — new flags: --owner (filter by owner), --width/--height (dimensions), --include-done (show completed tasks), --list-templates.
  • Setup Command Overhaul — clawvault setup now supports --theme neural|minimal|none, --graph-colors/--no-graph-colors, --bases/--no-bases, --canvas [template], --force, and -v --vault.
  • Init Command Flags — --no-bases, --no-tasks, --no-graph, --categories <list>, --canvas <template>, --theme, --minimal for full customization of new vaults.
  • Neural Graph Theme — dark background, colored nodes by category/tag, green neural-network links, golden glow on focused nodes. Applied via CSS snippet + Obsidian graph.json colorGroups.
  • Obsidian Bases Views — 5 auto-generated .base files on setup/init: all-tasks, blocked, by-project, by-owner, backlog.

Fixed

  • Date handling for bare dates in frontmatter — blocked, backlog list, and canvas templates no longer crash on Date objects.

Changed

  • Default setup theme is neural.
  • Brain canvas uses grouped architecture layout (was radial).
  • Project board uses text cards with owner/priority metadata (was file nodes).

v2.3.1 — February 14, 2026

Added

  • WebDAV server for Obsidian mobile sync — clawvault serve now supports WebDAV on /webdav/ for Remotely Save over Tailscale. Supports GET, PUT, DELETE, MKCOL, PROPFIND, OPTIONS, HEAD, MOVE, and COPY.

Improved

  • Tailscale server module refactored for WebDAV route integration.
  • 51 new WebDAV tests (553 total passing).

v2.3.0 — February 14, 2026

Added

  • Task management — clawvault task with add, list, update, done, and show.
  • Backlog management — clawvault backlog with add, list, and promote.
  • Blocked view — clawvault blocked for quick triage of blocked work.
  • Canvas dashboard — clawvault canvas generates an Obsidian JSON Canvas dashboard.
  • Vault activity stats in canvas — observation/reflection/task/session/document metrics included in generated dashboard.
  • Tailscale networking — clawvault serve, clawvault peers, and clawvault net-search for multi-vault collaboration.
  • New default categories — lessons, agents, commitments, handoffs, research, tasks, backlog (16 total, up from 9).
  • Ledger structure in init — clawvault init now creates ledger/raw/, ledger/observations/, ledger/reflections/ from day one.
  • Welcome note — new vaults get a welcome note in inbox/ with quick-start commands.

Improved

  • Init output shows memory categories, work categories, and ledger structure separately.
  • Post-init instructions link to docs.clawvault.dev.
  • Canvas layout engine with proper positioning, grouping, and color coding per JSON Canvas spec.

v2.2.0 — February 14, 2026

Added

  • Ledger-first observer architecture — raw transcripts preserved in ledger/raw/<source>/ as the canonical source of truth. Compiled observations are derived views in ledger/observations/YYYY/MM/DD.md.
  • Scored importance model — replaces emoji priorities with typed, scored format: [type|c=confidence|i=importance]. Types: decision, preference, fact, commitment, milestone, lesson, relationship, project.
  • clawvault reflect — promotes stable observation patterns into weekly reflections (ledger/reflections/YYYY-WNN.md). Can be scheduled via cron or run manually.
  • clawvault replay — ingest historical exports from ChatGPT, Claude, OpenCode, or OpenClaw into the observation pipeline.
  • clawvault rebuild — regenerate compiled observations from raw ledger transcripts.
  • clawvault archive — move old observations to ledger/archive/ (default 14 days retention).
  • clawvault migrate-observations — convert legacy emoji observations to scored format with non-destructive backups.
  • clawvault sync-bd — optional Beads task sync into views/now.md.
  • Graph guardrails — --max-hops on context command (default 2), derived-only nodes (no synthetic nodes for missing files), archive paths excluded from search/graph.
  • sleep --reflect option runs reflection pass after handoff.

Improved

  • Context profiles use importance buckets (structural/potential/contextual) instead of color names.
  • Tight-budget context preserves at least one top-ranked signal.
  • Observation reader supports both ledger and legacy paths with automatic deduplication.

Backward Compatibility

  • Existing emoji observations remain fully readable. New pipeline emits scored lines only.
  • migrate-observations provides a safe one-way migration with .emoji-backup.md files.

v2.1.2 — February 13, 2026

Improved

  • Observation compressor now captures business milestones — not just code. Client demos, pricing decisions, strategy pivots, signed contracts, pitch decks, and proposals are now treated as first-class project milestones alongside version releases and PR merges.
  • Priority enforcement rules updated: completed demos and pricing decisions are always critical (red), proposals and deploys are always notable (yellow).

v2.1.1 — February 13, 2026

Improved

  • Compressor priority rules for project milestones — version releases, PR merges, and shipped features are now enforced as critical observations. Deploys and new commands are enforced as notable. Previously these were marked as low-priority info and often dropped during compression.

v2.1.0 — February 13, 2026

Added

  • Active Session Observer — clawvault observe --active incrementally observes long-running OpenClaw sessions without waiting for them to go stale.
  • Smart threshold triggers — scaled by session size: <1MB triggers at 50KB new content, 1-5MB at 150KB, >5MB at 300KB.
  • Per-session byte cursors — tracks observation progress in .clawvault/observe-cursors.json so only new transcript deltas are compressed.
  • OpenClaw hook integration — heartbeat events run cheap statSync checks, triggers observation only when thresholds are crossed. Also fires on context compaction and /new commands.
  • Source label tagging — observations are tagged with their origin (telegram-dm, discord, main, etc.) for attribution.
  • Dry-run mode — --dry-run previews which sessions would be observed without compressing.
  • Helper scripts — observe-active-sessions.sh and observe-stale-sessions.sh for cron integration.

Changed

  • Extracted resolveVaultPath into shared lib/config.ts (was duplicated in observe command).
  • Created lib/session-utils.ts for OpenClaw session discovery utilities.

v2.0.2 — February 13, 2026

Fixed

  • Wiki-link corruption in observe compressor — LLMs were fusing word fragments into wiki-links during compression (e.g., reque[[people/pedro]]). Added sanitizeWikiLinks() post-processor.

v2.0.1 — February 13, 2026

Fixed

  • ClawHub metadata audit compliance (kind, env_optional, hooks, capabilities)
  • SKILL.md version sync with package.json

v2.0.0 — February 13, 2026

Major release: Memory Graph, Context Profiles, CLI modularization.

Added

  • Memory Graph Index — typed knowledge graph (.clawvault/graph-index.json) with wiki-link, tag, and frontmatter edges. Schema versioned with incremental rebuild.
  • Graph-Aware Context — clawvault context blends semantic search with graph-neighbor traversal, with explain signals in JSON output.
  • Context Profiles — clawvault context --profile with default, planning, incident, handoff presets for task-appropriate context injection.
  • clawvault compat — OpenClaw compatibility diagnostics. Checks hook wiring, event routing, SKILL.md, and handler safety. --strict mode for CI.
  • clawvault graph — graph summary and refresh diagnostics.
  • Doctor upgrade — now includes OpenClaw compatibility check summary.
  • Dashboard upgrades — vault parser emits typed nodes, typed edges, and type statistics.
  • Hook handler — flexible event routing via eventMatches() and normalizeEventToken(), --profile auto for context queries.

Changed

  • CLI modularized — monolithic clawvault.js split into 7 command groups (register-core, register-query, register-vault-operations, register-maintenance, register-resilience, register-session-lifecycle, register-template).
  • 367+ tests across core, commands, graph, dashboard, hooks, and CLI registration.

v1.11.2 — February 12, 2026

Fixed

  • Entity-slug routing — observations route to entity subfolders (people/pedro/2026-02-12.md instead of people/2026-02-12.md)
  • Root-level file prevention — observations never create files at vault root; always route to category folders
  • Entity name extraction — case-sensitive proper noun matching prevents capturing common words
  • Dedup improvements — router uses normalized content + Jaccard similarity to prevent duplicates

v1.11.1 — February 11, 2026

Fixed

  • Compressor priority enforcement — post-processes LLM output to upgrade misclassified priorities (decisions get critical, preferences get notable)
  • Temporal decay in reflector — low-priority observations older than 7 days auto-pruned; critical always kept
  • Exec summary in wake — richer context with observation summaries
  • Dedup normalization — strips timestamps, wiki-links, and whitespace before comparing

v1.11.0 — February 11, 2026

Removed

  • Cloud sync removed entirely — src/cloud/ module and clawvault cloud command stripped
  • All cloud-related dependencies and imports removed

ClawVault is now fully local-first. Zero network calls except optional LLM API for observe compression.

v1.10.2 — February 10, 2026

Added

  • Auto wiki-links in routed observations for Obsidian graph view

v1.10.1 — February 10, 2026

Fixed

  • Search docs: clarified memory_search vs clawvault search scope

v1.10.0 — February 10, 2026

Changed

  • Cleaned repo: removed internal docs, SEO bloat, dist from git

v1.9.6 — February 10, 2026

Fixed

  • Stress test fixes: priority calibration, budget enforcement, scoring, watch reliability, wake verbosity

v1.9.5 — February 10, 2026

Fixed

  • Stronger decision detection in compressor

v1.9.4 — February 10, 2026

Fixed

  • Enforce priority rules on LLM output, fix people routing patterns

v1.9.3 — February 10, 2026

Fixed

  • Watch, dedup, budget, classification, people routing fixes

v1.9.2 — February 10, 2026

Added

  • Gemini support for observer compressor (in addition to Anthropic and OpenAI)

v1.9.1 — February 10, 2026

Added

  • Auto-observe on sleep/wake
  • Context-aware token budgets for observation injection

v1.9.0 — February 10, 2026

Added

  • Observational memory system — compresses session transcripts into durable observations
  • Observer, Compressor, Reflector, Router, SessionWatcher, SessionParser modules
  • Priority system (critical, notable, info) with automatic classification
  • Vault routing: observations auto-categorize to decisions/, people/, lessons/, etc.
  • File watcher mode for real-time session observation
  • One-shot compression via --compress flag

v1.8.2 — February 9, 2026

Fixed

  • Path validation — OPENCLAW_HOME and OPENCLAW_STATE_DIR now properly validated (trimmed, require absolute paths)
  • Error handling — listAgents() wrapped in try/catch for malformed filesystem state

v1.8.1 — February 9, 2026

Added

  • OPENCLAW_HOME support — session utilities respect custom OpenClaw installations
  • OPENCLAW_STATE_DIR support — overrides state/agent paths

Compatibility

  • Verified with OpenClaw v2026.2.9
  • Hook handler confirmed working after OpenClaw's tsdown migration fix
  • Session transcript reading benefits from OpenClaw's parentId chain fix

v1.5.1 — February 6, 2026

Security

  • Fixed shell injection in hook handler — changed from execSync to execFileSync, arguments passed as array
  • Fixed prompt injection — checkpoint recovery data sanitized before injection, control characters stripped, length limited
  • Removed direct GitHub dependency for qmd — moved to optional peer dependency

v1.5.0 — February 6, 2026

Added

  • clawvault repair-session — repair corrupted OpenClaw session transcripts
    • Detects orphaned tool_result blocks referencing non-existent tool_use IDs
    • Identifies aborted tool calls with partial JSON
    • Automatically relinks parent chain after removals
    • Creates backup before repair (--no-backup to skip)
    • Dry-run mode with --dry-run
    • List sessions with --list
    • JSON output with --json for scripting
  • Session utilities — listAgents(), findMainSession(), findSessionById(), file helpers

v1.4.2 — February 6, 2026

Added

  • OpenClaw Hook Integration — automatic context death resilience
    • gateway:startup: detects if previous session died, injects alert
    • command:new: auto-checkpoints before session reset
  • clawvault wake — all-in-one session start (recover + recap + summary)
  • clawvault sleep — all-in-one session end with handoff (--next, --blocked, --decisions, --questions, --feeling)

Fixed

  • Readline import fix (was using readline/promises which bundlers couldn't resolve)

v1.4.1 — February 5, 2026

Added

  • clawvault doctor — vault health diagnostics
  • clawvault shell-init — shell integration setup

v1.4.0 — February 4, 2026

Added

  • qmd integration — semantic search via local embeddings
  • clawvault setup — auto-discovers OpenClaw memory folder
  • clawvault status — vault health, checkpoint age, qmd index
  • clawvault template — list/create/add with 7 built-in templates
  • clawvault link --backlinks — see what links to a file
  • clawvault link --orphans — find broken wiki-links

v1.2.0 — February 1, 2026

Added

  • clawvault remember and clawvault capture commands
  • clawvault search with keyword matching
  • Category-based storage (decisions, lessons, people, projects, preferences, commitments, inbox)
  • Daily notes integration

v1.1.0 — February 1, 2026

Initial release.

Added

  • Core CLI with store, search, checkpoint, recover
  • Vault initialization with .clawvault/ config directory
  • Markdown-based memory storage
  • Frontmatter parsing
  • Handoff/recap for session continuity
  • Wiki-linking and entity management
  • Structured memory categories

Environment Variables

All environment variables used by ClawVault and when they apply.

On this page

v2.4.4 — February 14, 2026Addedv2.4.3 — February 14, 2026Changedv2.4.2 — February 14, 2026Fixedv2.4.1 — February 14, 2026Changedv2.4.0 — February 14, 2026AddedFixedChangedv2.3.1 — February 14, 2026AddedImprovedv2.3.0 — February 14, 2026AddedImprovedv2.2.0 — February 14, 2026AddedImprovedBackward Compatibilityv2.1.2 — February 13, 2026Improvedv2.1.1 — February 13, 2026Improvedv2.1.0 — February 13, 2026AddedChangedv2.0.2 — February 13, 2026Fixedv2.0.1 — February 13, 2026Fixedv2.0.0 — February 13, 2026AddedChangedv1.11.2 — February 12, 2026Fixedv1.11.1 — February 11, 2026Fixedv1.11.0 — February 11, 2026Removedv1.10.2 — February 10, 2026Addedv1.10.1 — February 10, 2026Fixedv1.10.0 — February 10, 2026Changedv1.9.6 — February 10, 2026Fixedv1.9.5 — February 10, 2026Fixedv1.9.4 — February 10, 2026Fixedv1.9.3 — February 10, 2026Fixedv1.9.2 — February 10, 2026Addedv1.9.1 — February 10, 2026Addedv1.9.0 — February 10, 2026Addedv1.8.2 — February 9, 2026Fixedv1.8.1 — February 9, 2026AddedCompatibilityv1.5.1 — February 6, 2026Securityv1.5.0 — February 6, 2026Addedv1.4.2 — February 6, 2026AddedFixedv1.4.1 — February 5, 2026Addedv1.4.0 — February 4, 2026Addedv1.2.0 — February 1, 2026Addedv1.1.0 — February 1, 2026Added