obsidian-notes

What This Skill Does

The obsidian-notes skill enables seamless integration between OpenClaw and your local Obsidian knowledge base. By utilizing the obsidian-cli tool, this agent can perform advanced file management and search operations within your vaults. Unlike manual file manipulation, this skill manages the complexity of Obsidian's graph-based structure, specifically handling [[wikilinks]] and internal referencing during file move or rename operations. It acts as an automation layer over your plain-text Markdown files, allowing the AI to read content, perform complex queries, and execute structural changes without breaking your note dependencies.

Installation

To install this skill, run the following command in your terminal within the OpenClaw environment: clawhub install openclaw/skills/skills/164149043/obsidian-notes Ensure you have Obsidian installed on your machine and have initialized the CLI tool via obsidian-cli set-default "<vault-name>" to allow the agent to locate your notes.

Use Cases

This skill is ideal for personal knowledge management (PKM) automation. Use it to:

• Organize massive vaults by programmatically moving notes based on content analysis.
• Quickly search through legacy notes or project-specific documentation using the full-text search capability.
• Generate daily logs, meeting summaries, or project drafts directly into specific folders using the creation command.
• Perform bulk refactoring of note hierarchies while preserving link integrity, a task that is error-prone when done manually via standard file explorers.

Example Prompts

1. "Find all notes in my 'Projects' folder that mention the 'Q4 Strategy' and move them into a new folder named 'Archive/2023-Q4'."
2. "Create a new note titled 'Daily/2023-10-27' and add the following content: 'Reflecting on the system architecture update today.'"
3. "Search my vault for any mentions of 'technical debt' and summarize the findings into a list for me."

Tips & Limitations

Always prefer direct filesystem edits for simple text updates, as this is faster than the CLI overhead. However, always use the move command when renaming files to trigger the automatic link refactoring feature. Note that the agent cannot access vaults if the file permissions are restricted or if the obsidian.json config file is corrupted. Avoid writing to hidden dot-folders, as these are reserved for system configurations. When working with multiple vaults, always ensure the default vault is correctly set to prevent unintended cross-vault modifications.