obsidian-fns
Control a remote Obsidian vault through Fast Note Sync. Use when reading, searching, writing, or appending notes in Obsidian from OpenClaw, especially for remote vault workflows that do not have direct filesystem access.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/attack-flower/obsidian-fnsWhat This Skill Does
The obsidian-fns skill enables OpenClaw AI agents to interface directly with remote Obsidian vaults using the Fast Note Sync (FNS) protocol. It serves as a bridge for environments where direct filesystem access to the vault is restricted or impossible. By abstracting complex API interactions into simplified high-level commands, it allows the agent to treat a remote note-taking system as a structured database. The skill supports a full lifecycle of note management, including searching for keywords, reading content, creating new files, and appending information to existing documents without needing to pull or push entire repositories.
Installation
You can integrate this skill into your OpenClaw environment by running the following command in your terminal:
clawhub install openclaw/skills/skills/attack-flower/obsidian-fns
Ensure that your environment is properly configured with your FNS credentials, as the script relies on the base directory configuration for session management and token reuse. Refer to references/usage.md for specific environment variable requirements.
Use Cases
This skill is ideal for users who manage their personal or professional knowledge bases in Obsidian while leveraging AI for automation. Key use cases include:
- Knowledge Management: Automatically indexing or retrieving project notes based on AI-generated research.
- Automated Journaling: Appending daily work logs or summaries to a vault path automatically at the end of a session.
- Remote Collaboration: Updating shared project documentation or task lists from within the AI agent's chat interface.
- Content Curation: Aggregating information from multiple sources into a specific Obsidian vault path for later review.
Example Prompts
- "Search my Obsidian vault for notes related to the 'Q4 Strategy' and read the most recent one."
- "Append a new entry to 'Work/Logs/Today.md' stating that I completed the integration of the obsidian-fns skill."
- "Create a new note in 'Inbox/Ideas' titled 'AI Integration' with the following content: # Initial Thoughts about FNS."
Tips & Limitations
Always prioritize the use of the action layer (fns_actions.py) over direct CLI calls to maintain stability. If you are uncertain about the structure of a path, use search-notes first to verify the file location. Avoid blind overwrites; use append-note whenever possible to preserve your data history. This skill is capable of handling complex path names, including those with spaces and Chinese characters, ensuring robustness for international users. Note that direct execution of the underlying FNS CLI should be reserved solely for debugging or diagnostics when the high-level actions fail to provide the necessary output.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-attack-flower-obsidian-fns": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-write, file-read, external-api, code-execution