| name | obsidian-fns |
| description | 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. |
obsidian-fns
Use this skill to operate a remote Obsidian vault through Fast Note Sync.
Use the action layer by default
Prefer these high-level commands for normal work:
python3 {baseDir}/scripts/fns_actions.py search-notes --keyword "OpenClaw"
python3 {baseDir}/scripts/fns_actions.py read-note --path "OpenClaw/API-Test.md"
python3 {baseDir}/scripts/fns_actions.py write-note --path "OpenClaw/API-Test.md" --content "# hello"
python3 {baseDir}/scripts/fns_actions.py append-note --path "OpenClaw/API-Test.md" --content "\n- one more line"
Use the lower-level CLI only when you need debugging, unsupported operations, or direct API diagnosis:
python3 {baseDir}/scripts/fns.py --help
Operating rules
- Prefer
search-notes, read-note, write-note, and append-note for routine tasks.
- Read first if the target note/path is uncertain.
- Avoid overwriting an existing note blindly when append is enough.
- For exploratory or risky work, create or use a dedicated test path first.
- Keep existing compatibility assumptions intact unless the user explicitly asks to migrate config keys or paths.
Supported capabilities
This skill has verified support for:
- login and token reuse
- vault listing and tree inspection
- note search and read
- write, append, prepend, replace
- rename and move
- history lookup
- Chinese paths and paths with spaces
References
Read these only when needed:
references/usage.md — commands, configuration sources, validated environment, and packaging notes
