
obsidian
✓ Official★ 3by firecrawl · part of firecrawl/openclaw
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Inspect the full instructions your agent will receiveExpandCollapse
This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.
by firecrawl
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
npx skills add https://github.com/firecrawl/openclaw --skill obsidian
Download ZIPGitHub3
Obsidian
Obsidian vault = a normal folder on disk.
Vault structure (typical)
-
Notes:
*.md(plain text Markdown; edit with any editor) -
Config:
.obsidian/(workspace + plugin settings; usually don’t touch from scripts) -
Canvases:
*.canvas(JSON) -
Attachments: whatever folder you chose in Obsidian settings (images/PDFs/etc.)
Find the active vault(s)
Obsidian desktop tracks vaults here (source of truth):
~/Library/Application Support/obsidian/obsidian.json
obsidian-cli resolves vaults from that file; vault name is typically the folder name (path suffix).
Fast “what vault is active / where are the notes?”
-
If you’ve already set a default:
obsidian-cli print-default --path-only -
Otherwise, read
~/Library/Application Support/obsidian/obsidian.jsonand use the vault entry with"open": true.
Notes
-
Multiple vaults common (iCloud vs
~/Documents, work/personal, etc.). Don’t guess; read config. -
Avoid writing hardcoded vault paths into scripts; prefer reading the config or using
print-default.
npx skills add https://github.com/firecrawl/openclaw --skill obsidianRun this in your project — your agent picks the skill up automatically.
obsidian-cli quick start
Pick a default vault (once):
-
obsidian-cli set-default "<vault-folder-name>" -
obsidian-cli print-default/obsidian-cli print-default --path-only
Search
-
obsidian-cli search "query"(note names) -
obsidian-cli search-content "query"(inside notes; shows snippets + lines)
Create
-
obsidian-cli create "Folder/New note" --content "..." --open -
Requires Obsidian URI handler (
obsidian://…) working (Obsidian installed). -
Avoid creating notes under “hidden” dot-folders (e.g.
.something/...) via URI; Obsidian may refuse.
Move/rename (safe refactor)
-
obsidian-cli move "old/path/note" "new/path/note" -
Updates
[[wikilinks]]and common Markdown links across the vault (this is the main win vsmv).
Delete
obsidian-cli delete "path/note"
Prefer direct edits when appropriate: open the .md file and change it; Obsidian will pick it up.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.