An Obsidian vault your agent can actually read.

A durable Obsidian vault scaffold for human/agent knowledge work. Zettelclaw creates a simple five-folder vault, typed markdown templates, inbox capture, QMD collections, and OpenClaw integration — so your agent can search and navigate your notes without inventing its own system.

npx zettelclaw init
npx zettelclaw verify

init creates the vault scaffold, seeds starter notes and templates, configures Obsidian defaults, downloads bundled plugins, initializes Git when selected, creates QMD collections when qmd is installed, and patches OpenClaw when a workspace is detected.

Starter content includes 01 Notes/Zettelclaw Vault Principles.md, 00 Inbox/Build A Capture Habit.md, and 02 Journal/<today>.md.

• QMD — creates zettelclaw-inbox, zettelclaw-notes, zettelclaw-journal, and zettelclaw-attachments collections when qmd is available
• OpenClaw — patches agents.defaults.memorySearch.extraPaths and installs the bundled zettelclaw skill when a workspace is available
• Obsidian defaults — enables Calendar, optional Obsidian Git, and the Minimal theme preset/tooling when selected

zettelclaw init                # create and configure a Zettelclaw vault
zettelclaw verify              # validate vault, plugins, QMD, and OpenClaw wiring

zettelclaw init --vault        # override vault path
zettelclaw init --workspace    # override OpenClaw workspace path
zettelclaw init --sync         # git | obsidian-sync | none
zettelclaw init --theme        # minimal | obsidian
zettelclaw init --yes          # accept defaults non-interactively

verify also supports --vault, --workspace, and --yes.

See docs/SPEC.md for the full Zettelclaw product and vault contract.

MIT