← 返回 Skills 市场

Obsidian Openclaw Sync

Name: Obsidian Openclaw Sync
Author: boyd4y

作者 Yang Jun · GitHub ↗ · v1.0.1

cross-platform ✓ 安全检测通过

857

总下载

当前安装

版本数

在 OpenClaw 中安装

/install obsidian-openclaw-sync

功能描述

Sync Obsidian OpenClaw config across multiple iCloud devices. Manages symlinks for seamless multi-device sync.

使用说明 (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.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):
  ✓ \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 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

Sync Helper Script - Core Python script for vault detection

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install obsidian-openclaw-sync
安装完成后，直接呼叫该 Skill 的名称或使用 /obsidian-openclaw-sync 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug obsidian-openclaw-sync

版本 1.0.1

许可证 —

累计安装 13

当前安装数 13

历史版本数 2

常见问题