← Back to Skills Marketplace
857
Downloads
0
Stars
13
Active Installs
2
Versions
Install in OpenClaw
/install obsidian-openclaw-sync
Description
Sync Obsidian OpenClaw config across multiple iCloud devices. Manages symlinks for seamless multi-device sync.
README (SKILL.md)
Obsidian OpenClaw Sync
Helper tool for syncing OpenClaw configuration between iCloud Drive and local Obsidian vaults.
Purpose
This skill solves the problem of syncing OpenClaw configuration across multiple devices via iCloud:
- Automatically detects all iCloud vaults with OpenClaw configs
- Creates symlinks from local to iCloud for seamless sync
- Supports multi-agent workspace templates (workspace_, workspace-)
- Manages
openclaw.jsonsync with overwrite control
Dependencies
| Dependency | Required | Description |
|---|---|---|
python3 |
Yes | Python 3.x (macOS comes with Python pre-installed) |
macOS |
Yes | This skill only works on macOS (iCloud Drive integration) |
obsidian-icloud-sync |
Yes | Obsidian must be set up to sync vaults via iCloud Drive |
Check Dependencies
# Check Python availability
python3 --version
# Check iCloud Obsidian path exists
ls -ld ~/Library/Mobile\ Documents/iCloud~md~obsidian/Documents
Usage
/obsidian-openclaw-sync [command] [options]
Commands
| Command | Description |
|---|---|
status |
Show all iCloud vaults with agents and skills, indicates sync status |
setup |
Interactive setup to sync a vault to local |
unset |
List and remove local symlinks |
Options
| Option | Short | Description |
|---|---|---|
--vault N |
-v N |
Pre-select vault by index (default: interactive) |
--overwrite |
-w |
Overwrite local openclaw.json with symlink to iCloud version |
--no-confirm |
-y |
Skip confirmation prompt (auto-confirm) |
Examples
# Check sync status (shows all iCloud vaults)
/obsidian-openclaw-sync
# Interactive setup (select vault, create symlinks)
/obsidian-openclaw-sync setup
# Setup with overwrite (replace local openclaw.json with iCloud symlink)
/obsidian-openclaw-sync setup --overwrite
# Setup without confirmation prompt (auto-confirm)
/obsidian-openclaw-sync setup --no-confirm
# Setup specific vault without prompts
/obsidian-openclaw-sync setup --vault 1 --no-confirm
# List and remove local symlinks
/obsidian-openclaw-sync unset
Output Format
✓ iCloud Obsidian: /Users/.../iCloud~md~obsidian/Documents
✓ Valid Vaults (N):
✓ \x3Cvault-name>
Agents (N): \x3Cagent1>, \x3Cagent2>, ...
Skills (N): \x3Cskill1>, \x3Cskill2>, ...
○ \x3Cvault-name> [openclaw.json not found (recommended)]
✗ Invalid Vaults (N):
✗ \x3Cvault-name> (missing: .obsidian/)
Local Config: .openclaw
Agents (N): \x3Cagent1>, \x3Cagent2>, ...
Skills (N): \x3Cskill1>, \x3Cskill2>, ...
Synced Directories
| Source (iCloud) | Target (Local) |
|---|---|
media/ |
./media/ |
projects/ |
./projects/ |
team/ |
./team/ |
skills/ |
./skills/ |
workspace-*/ |
./workspace-*/ |
.openclaw/*.json |
./.openclaw/*.json |
openclaw.json |
./openclaw.json (with --overwrite) |
Multi-Device Sync Flow
- Device 1: Run
setupto create symlinks to iCloud vault - Device 2: Run
setup --overwriteto replace local config with iCloud symlink - All devices: Changes sync via iCloud Drive automatically
References
- Sync Helper Script - Core Python script for vault detection
Usage Guidance
This tool appears to do exactly what it says — locate Obsidian vaults in iCloud and manage symlinks for OpenClaw config. Before installing/running: (1) review scripts/sync_helper.py and run.sh yourself (they're included) to confirm behavior; (2) run the status command first (no changes) to verify detected vaults; (3) back up your local ~/.openclaw and any openclaw.json files before using --overwrite; (4) run the tool on a test machine or sandbox if you are unsure; (5) note there is no homepage or publisher metadata — prefer installing software from known sources or add extra scrutiny if you cannot verify the author.
Capability Analysis
Type: OpenClaw Skill
Name: obsidian-openclaw-sync
Version: 1.0.1
The skill is designed to sync OpenClaw configuration files and directories between local and iCloud Obsidian vaults using symlinks. The `SKILL.md` provides clear instructions and does not contain any prompt injection attempts. The `run.sh` script is a simple wrapper for the Python script. The core `sync_helper.py` script performs file system operations (finding paths, creating/removing symlinks, creating directories) within the user's home directory, specifically targeting known Obsidian/OpenClaw configuration paths. It uses `pathlib` for safer file operations and includes user confirmation for destructive actions like unlinking existing files/symlinks. There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or obfuscation. All actions align with the stated purpose and lack malicious intent.
Capability Assessment
Purpose & Capability
Name/description match what is present in SKILL.md and the included scripts: the Python helper and wrapper bash script locate the macOS iCloud Obsidian path, enumerate vaults, inspect .obsidian/openclaw.json, report status, and create/manage symlinks. No unrelated services, credentials, or binaries are requested.
Instruction Scope
SKILL.md instructs running the bundled run.sh which invokes the bundled Python script. The instructions operate on local filesystem paths (~/Library/... and ~/.openclaw) and include an explicit --overwrite option that will replace local openclaw.json with an iCloud symlink. There are no instructions to collect system-wide secrets, call external endpoints, or read unrelated configuration files. The overwrite behavior is explicit and should be used with care.
Install Mechanism
No install spec is provided (instruction-only skill with bundled scripts). The runtime is the included run.sh and scripts/sync_helper.py; nothing is downloaded or installed from the network. This is the lower-risk model for distribution, but verify the bundled scripts before running.
Credentials
The skill declares no required environment variables or credentials and the code does not appear to access environment secrets. It only uses standard filesystem access under the user's home directory, which is necessary for the stated purpose.
Persistence & Privilege
always is false and the skill does not request elevated/system-wide persistence. It performs local file operations and symlink management scoped to the user's home directory and its own config; it does not modify other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install obsidian-openclaw-sync - After installation, invoke the skill by name or use
/obsidian-openclaw-sync - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
obsidian-openclaw-sync 1.0.1
- Added support for syncing the media/ directory between iCloud and local vaults.
- Updated documentation and directory sync table to reflect media/ inclusion.
v1.0.0
obsidian-openclaw-sync v1.0.0
- Initial release: syncs Obsidian OpenClaw configuration across multiple iCloud-enabled macOS devices.
- Automatically detects iCloud vaults, creates symlinks for key config files and directories.
- Supports multi-agent workspace templates and manages openclaw.json with overwrite option.
- Provides status, setup, and unset commands for easy sync management.
- Built for macOS with iCloud and requires Obsidian vaults set up for iCloud Drive syncing.
Metadata
Frequently Asked Questions
What is Obsidian Openclaw Sync?
Sync Obsidian OpenClaw config across multiple iCloud devices. Manages symlinks for seamless multi-device sync. It is an AI Agent Skill for Claude Code / OpenClaw, with 857 downloads so far.
How do I install Obsidian Openclaw Sync?
Run "/install obsidian-openclaw-sync" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Obsidian Openclaw Sync free?
Yes, Obsidian Openclaw Sync is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Obsidian Openclaw Sync support?
Obsidian Openclaw Sync is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Obsidian Openclaw Sync?
It is built and maintained by Yang Jun (@boyd4y); the current version is v1.0.1.
More Skills