obsidian

What This Skill Does

The obsidian skill enables your OpenClaw agent to interact directly with an Obsidian knowledge base. By leveraging specialized CLI tools, the agent can perform advanced fuzzy and phonetic searches across your vault to retrieve context, manage markdown files, and handle frontmatter metadata. It integrates seamlessly with your local file system, allowing the agent to read, create, edit, and organize notes based on your conversational prompts. It also supports semantic features like wikilinks, tags, and automated folder suggestion based on content analysis.

Installation

To install this skill, run the following command in your OpenClaw terminal: clawhub install openclaw/skills/skills/ruslanlanket/obisdian-direct Ensure your environment variable OBSIDIAN_VAULT is correctly set to the absolute path of your Obsidian vault directory (e.g., /home/ruslan/webdav/data/ruslain). The skill automatically looks for scripts in the workspace directory defined during installation.

Use Cases

• Knowledge Retrieval: Quickly find specific information buried in years of notes using phonetic search when you can't recall exact titles.
• Note Organization: Automate the categorization of new notes using the --auto-folder flag or the suggest-folder tool to keep your vault clean.
• Iterative Drafting: Update meeting minutes or project documentation by appending, prepending, or replacing sections within existing notes based on new project developments.
• Linking Knowledge: Maintain a web of information by using the agent to cross-reference existing notes via wikilinks as it generates new content.

Example Prompts

1. "Search my vault for all notes related to 'project alpha' and summarize the pending tasks mentioned in them."
2. "Create a new meeting note for today titled 'Sync with Marketing' and automatically file it in the appropriate folder."
3. "Append a new section titled 'Action Items' to the note 'Q3 Strategy' with the following list: fix API latency, update documentation, and review budget."

Tips & Limitations

• Performance: For very large vaults, the fuzzy search uses ripgrep for speed, but deep indexing might take a moment. Always use the --json flag when scripting automation to ensure predictable output parsing.
• Frontmatter Integrity: When using the edit commands, be mindful that the agent respects the YAML frontmatter. Ensure your prompt doesn't accidentally overwrite critical created or modified timestamps unless necessary.
• Safety: Because this skill directly modifies files, ensure you have backups or Git version control enabled on your vault. The agent lacks undo-functionality natively, so review edits carefully.