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.json sync 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):
✓ <vault-name>
Agents (N): <agent1>, <agent2>, ...
Skills (N): <skill1>, <skill2>, ...
○ <vault-name> [openclaw.json not found (recommended)]
✗ Invalid Vaults (N):
✗ <vault-name> (missing: .obsidian/)
Local Config: .openclaw
Agents (N): <agent1>, <agent2>, ...
Skills (N): <skill1>, <skill2>, ...
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
setup to create symlinks to iCloud vault - Device 2: Run
setup --overwrite to replace local config with iCloud symlink - All devices: Changes sync via iCloud Drive automatically
References