Commands
init & setup
Initialize a new vault or auto-discover and configure an existing one
The init and setup commands handle vault creation and configuration. Use init to create a new vault from scratch, or setup to auto-discover and configure an existing memory folder.
clawvault init
Create a new ClawVault in the specified directory.
clawvault init [path] [options]Options
| Flag | Description | Default |
|---|---|---|
-n, --name <name> | Vault name | Directory name |
--qmd | Set up qmd semantic search collection | false |
--qmd-collection <name> | qmd collection name | Vault name |
--no-bases | Skip Obsidian Bases file generation | false |
--no-tasks | Skip tasks/ and backlog/ directories | false |
--no-graph | Skip initial graph build | false |
--categories <list> | Comma-separated custom categories | Default 16 |
--canvas <template> | Generate a canvas on init (default, brain, project-board, sprint) | None |
--theme <style> | Graph color theme: neural, minimal, none | none |
--minimal | Minimal vault — memory categories only, no tasks/bases/graph | false |
Examples
# Full initialization with all defaults
clawvault init ~/my-vault --name "work-memory"
# Initialize with neural graph theme and brain canvas
clawvault init ~/agent-memory --theme neural --canvas brain
# Minimal vault for a lightweight agent
clawvault init ./memory --minimal
# Custom categories only
clawvault init ./memory --categories "notes,research,code,docs"
# Skip task management, just memory
clawvault init ~/vault --no-tasks --no-basesclawvault setup
Auto-discover and configure a ClawVault from an existing memory folder.
clawvault setup [options]Options
| Flag | Description | Default |
|---|---|---|
-v, --vault <path> | Target vault path | Auto-discovered |
--theme <style> | Graph color theme: neural, minimal, none | neural |
--graph-colors / --no-graph-colors | Opt in/out of Obsidian graph theming | Included |
--bases / --no-bases | Opt in/out of Obsidian Bases task views | Included |
--canvas [template] | Generate canvas dashboard | Not generated |
--force | Overwrite existing configuration files | Skip existing |
By default, setup applies the neural graph theme and generates Obsidian Bases views for task management. Use --no-graph-colors or --no-bases to skip these.
Examples
# Full setup with neural theme (default behavior)
clawvault setup
# Setup with brain architecture canvas
clawvault setup --canvas brain
# Structure only — no visual config
clawvault setup --no-graph-colors --no-bases
# Force-refresh all configs
clawvault setup --force --canvas project-board
# Target a specific vault
clawvault setup -v ~/projects/agent-memoryWhen to Use Which
| Scenario | Command |
|---|---|
| Starting fresh | clawvault init [path] |
| Existing OpenClaw workspace | clawvault setup |
| Lightweight agent vault | clawvault init --minimal |
| Add visual config to existing vault | clawvault setup --force |
| Agent needs task management only | clawvault init --no-graph --canvas project-board |