obsidian

What This Skill Does

The obsidian skill enables your OpenClaw AI agent to interact directly with your personal knowledge base stored in an Obsidian vault. By leveraging fuzzy search capabilities, structured file management, and frontmatter editing, the agent can serve as an active librarian for your notes. It supports creating, reading, and modifying Markdown files while respecting the specific link syntax (wikilinks) and tagging systems used in Obsidian. The skill provides seamless navigation between notes, allowing the AI to summarize documents, link related concepts, and organize information effectively using auto-folder detection.

Installation

To install this skill, run the following command in your OpenClaw environment: clawhub install openclaw/skills/skills/ruslanlanket/obsidian-direct Ensure your OBSIDIAN_VAULT environment variable is correctly set in your shell profile pointing to your local vault directory (e.g., /home/ruslan/webdav/data/ruslain).

Use Cases

• Knowledge Retrieval: Quickly search through thousands of notes to find specific information or context for a current project.
• Note Maintenance: Automatically append summaries, update tags, or restructure sections of existing documentation based on new inputs.
• Organization: Use the auto-folder suggestion feature to keep your vault organized without manual intervention.
• Content Linking: Maintain a healthy web of knowledge by having the agent suggest and insert relevant wikilinks between disparate notes.

Example Prompts

1. "Search for my notes about the Q4 marketing plan and summarize the key action items for me."
2. "Create a new note titled 'AI Ethics' in the Research folder with the content 'AI development should prioritize human values.' and add the tag #ethics."
3. "Open the note 'Project Alpha' and append a section titled 'Next Steps' listing the tasks we discussed today."

Tips & Limitations

• Search Performance: The skill utilizes ripgrep for blazing-fast fuzzy searches, even in large vaults.
• Frontmatter Sensitivity: When editing, ensure your note structure includes valid YAML frontmatter; the script expects specific fields like created and tags for optimal indexing.
• Path Configuration: Always verify the OBSIDIAN_VAULT path; if the path is incorrect, scripts will fail to locate files.
• Non-destructive Edits: Always check the contents of a note after an automated replace operation if you are unsure about the existing content format.