aj-obsidian

What This Skill Does

The aj-obsidian skill empowers the OpenClaw agent to seamlessly interact with your Obsidian knowledge base. Since Obsidian vaults are simply directories of plain Markdown files, this skill leverages the obsidian-cli to perform complex note management, searching, and refactoring tasks. It acts as an bridge between your AI agent and your second brain, allowing the agent to read, create, update, and organize notes without needing to open the Obsidian GUI.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/aceundefeated/aj-obsidian Ensure you have Obsidian installed and the obsidian-cli configured correctly on your system path before initialization.

Use Cases

1. Knowledge Retrieval: Quickly surface information across multiple vaults by searching note titles or full-text content.
2. Automated Note Capture: Automatically log meeting notes, web clippings, or task logs directly into specific folders within your vault.
3. Refactoring and Maintenance: Use the safe move/rename functionality to update titles and file structures without breaking your internal [[wikilinks]], a process that manually editing files cannot guarantee.
4. Workflow Automation: Connect Obsidian to other system events, such as moving a completed project note to an 'Archive' folder upon the completion of a related task.

Example Prompts

1. "Find the note about the quarterly planning session and append a new bullet point: 'Finalize budget review by Friday'."
2. "Search my vault for any notes mentioning 'API documentation' and list the file paths."
3. "Move the note 'Project Alpha' to the 'Active Projects/Completed' folder and ensure all internal links are updated."

Tips & Limitations

• Vault Handling: Obsidian vaults are defined by folder paths. Avoid hardcoding these; use obsidian-cli set-default to manage your primary vault and let the agent query the configuration file for accuracy.
• Direct Editing: For simple text adjustments, it is often faster to let the agent perform direct file system writes to the .md files. Only use URI-based commands (--open) when you need to trigger Obsidian features or UI-side behavior.
• Limitations: Do not attempt to modify the .obsidian/ configuration folder or core workspace settings via the agent, as this can corrupt your UI state. Stick to managing content files for maximum stability.