A specialized automation skill for saving markdown content and diagrams from an AI agent directly into a remote Obsidian vault via secure SSH transfer.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install save-to-obsidian
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install save-to-obsidian using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Save to Obsidian?
The Save to Obsidian skill is designed for developers and power users who need to bridge the gap between AI-generated content and their Personal Knowledge Management (PKM) systems. It allows an agent to programmatically export notes, research, and technical documentation to a remote Obsidian vault. This is especially critical for workflows running on machines without native iCloud sync, such as Linux servers or remote development environments.
By integrating this functionality into your Openclaw Skills library, you enable your agent to maintain your knowledge base with structured, formatted markdown. The skill handles the heavy lifting of secure file transfer while ensuring that all content adheres to Obsidian-specific formatting standards, including native Mermaid diagram support and wiki-link compatibility.
Save to Obsidian Use Cases
- Automatically exporting research summaries or meeting notes from an AI session to your knowledge base.
- Synchronizing technical documentation generated on a headless Ubuntu server to a local Obsidian vault.
- Archiving system logs or project status updates directly into a structured vault folder.
- Ensuring AI-generated diagrams and tables are correctly formatted for native Obsidian rendering.
How Save to Obsidian Works
- The agent identifies the markdown content to be saved and formats it according to pre-defined Obsidian standards.
- A temporary markdown file is generated on the local system with a sanitized kebab-case filename.
- The skill retrieves SSH host, user, and vault path configuration from the workspace environment.
- An scp command is executed to securely transfer the file to the remote vault location.
- Upon successful transfer (exit code 0), the local temporary file is deleted and the agent confirms completion.
Save to Obsidian Setup
To use this within the ecosystem of Openclaw Skills, you must configure your remote credentials in your workspace TOOLS.md file. Ensure your environment has SSH key-based authentication enabled for the target host.
Update your TOOLS.md with these entries:
## Obsidian Remote Vault
- SSH host: your-remote-server.com
- SSH user: your-username
- Vault path: /home/user/Obsidian/MyVault/
No additional API tokens are required as the skill leverages standard system-level SSH tools.
Save to Obsidian Data Schema & Taxonomy
The skill organizes data and enforces formatting to ensure the best experience within Obsidian:
| Element | Requirement | Description |
|---|---|---|
| Filenames | Kebab-case | All spaces are replaced with hyphens for cross-platform safety. |
| Diagrams | Mermaid JS | Uses fenced code blocks; ASCII art is strictly avoided. |
| Links | Wiki-links | Internal references use the [[note-name]] syntax. |
| Metadata | YAML | Optional frontmatter can be included for tagging and properties. |
| Headers | Markdown | Proper H1-H6 structure is enforced for the Obsidian outline panel. |
Save to Obsidian Advanced Features
- Automatic filename sanitization to prevent sync errors on remote filesystems.
- Mandatory Mermaid diagram enforcement to ensure visual assets are rendered natively by Obsidian.
- Integration with Openclaw Skills via the exec tool, allowing for seamless shell-level execution.
- Silent overwrite logic to maintain the latest version of notes without manual intervention.
- Support for remote vaults located on servers that lack native GUI or iCloud integration.
SKILL.md
Loading
Related Openclaw Skills
Rotate OpenRouter Key
A specialized utility to securely replace OpenRouter API keys across multiple configuration files and environment variables.
ROSE Docker Build
A specialized environment for building the ROSE source-to-source compiler using Docker to ensure toolchain compatibility and dependency isolation.
ROSE Container Tools
A streamlined environment for building and running ROSE-based source code analysis tools within a Docker container to ensure toolchain compatibility.
OpenClaw Use Case Catalog
A curated knowledge base and research tool for discovering, documenting, and sharing real-world automation scenarios powered by OpenClaw.
Skill Engineer
An advanced multi-agent framework for designing, auditing, and maintaining high-quality Openclaw Skills through automated design and testing loops.
Mermaid Diagram Generator
A powerful automation skill for creating professional, consistently styled Mermaid diagrams from technical content using smart templates.
METADATA
Featured*
