← Back to Skills Marketplace
Obsidian FNS
by
attack-flower
· GitHub ↗
· v0.3.0
· MIT-0
119
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install 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 re...
README (SKILL.md)
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 "\
- 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, andappend-notefor 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
Usage Guidance
This package appears to be a straightforward Fast Note Sync client. Before installing, verify the baseUrl you will use points to a trusted Fast Note Sync server (an attacker-controlled baseUrl could receive your token and note data). Be aware that running the login action will store a token in ~/.config/fast-note-sync/config.json and the scripts read ~/.openclaw/openclaw.json if present. If you do not trust the remote server, avoid using login or providing credentials; instead use ephemeral tokens or a test vault. Inspect the scripts in your environment if you want to confirm there are no additional network targets or changes to other local files.
Capability Analysis
Type: OpenClaw Skill
Name: obsidian-fns
Version: 0.3.0
The obsidian-fns skill is a legitimate tool designed to interface with a 'Fast Note Sync' API for remote Obsidian vault management. The scripts (fns.py and fns_actions.py) implement standard CRUD operations for notes and handle authentication via tokens or credentials provided by the user through environment variables or local config files (~/.config/fast-note-sync/config.json). No evidence of malicious intent, data exfiltration to hardcoded endpoints, or prompt injection was found; the code follows its stated purpose using standard Python libraries.
Capability Assessment
Purpose & Capability
The name/description (remote Obsidian via Fast Note Sync) matches the included scripts and CLI actions. The code implements login, vault listing, search, read, write, append, rename, move, histories, and related endpoints against a user-configurable baseUrl. It also documents the configuration files and environment variables it supports; these all align with the stated purpose.
Instruction Scope
SKILL.md and references instruct the agent to run the bundled Python scripts (fns_actions.py → fns.py). The scripts read config from ~/.config/fast-note-sync/config.json and ~/.openclaw/openclaw.json and use environment variables prefixed FNS_ if present. This is expected for a client that needs connection credentials, but it means the skill will read local config files and can persist a token to ~/.config/fast-note-sync/config.json. The instructions do not ask to read arbitrary unrelated files or send data to unexpected endpoints; network calls are made to whatever baseUrl the user configures.
Install Mechanism
There is no install spec (instruction-only for installation), and the package contains plain Python scripts that are executed locally. No downloads from external URLs or package installs are performed by the skill itself, which keeps install risk low.
Credentials
The registry metadata declares no required env vars or credentials, which matches that credentials are optional until runtime. The code supports FNS_BASE_URL, FNS_TOKEN, FNS_CREDENTIALS, FNS_PASSWORD, FNS_VAULT, and a timeout variable. Requesting tokens/credentials is proportional to the skill's purpose, but users should note that the skill can read ~/.openclaw/openclaw.json (to respect legacy config) and will write tokens to ~/.config/fast-note-sync/config.json after login.
Persistence & Privilege
The skill does not set always:true and does not modify other skills' configuration. Its persistent effect is limited to writing its own config file (~/.config/fast-note-sync/config.json) for token reuse, which is reasonable for a client that caches tokens.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install obsidian-fns - After installation, invoke the skill by name or use
/obsidian-fns - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.3.0
First public release: package obsidian-fns as a distributable OpenClaw skill; support searching, reading, writing, and appending remote
Obsidian notes via Fast Note Sync; include low-level CLI and high-level action wrapper; validate packaging, install flow, and publish-safe metadata.
Metadata
Frequently Asked Questions
What is 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 re... It is an AI Agent Skill for Claude Code / OpenClaw, with 119 downloads so far.
How do I install Obsidian FNS?
Run "/install obsidian-fns" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Obsidian FNS free?
Yes, Obsidian FNS is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Obsidian FNS support?
Obsidian FNS is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Obsidian FNS?
It is built and maintained by attack-flower (@attack-flower); the current version is v0.3.0.
More Skills