核心用法
obsidian-openclaw-sync 是专为 macOS 设计的 iCloud 同步辅助工具，解决 OpenClaw 用户在多苹果设备间保持配置一致的痛点。通过检测 iCloud Drive 中的 Obsidian vault，自动创建符号链接将本地配置指向云端，实现 openclaw.json、skills、agents、workspace 模板等内容的实时同步。
主要命令包括：status 查看所有 iCloud vault 的同步状态；setup 交互式选择 vault 并创建符号链接；unset 清理本地符号链接。支持 --overwrite 强制用 iCloud 版本覆盖本地配置，--vault N 指定 vault 索引跳过交互，--no-confirm 静默执行。
显著优点
1. 零配置同步：利用苹果原生 iCloud Drive，无需第三方同步服务
2. 多设备无缝切换：Mac、iPad、iPhone 间配置实时一致
3. 智能检测：自动识别含 OpenClaw 配置的 vault，区分有效/无效路径
4. 细粒度控制：支持 workspace 多代理模板同步，保留本地或覆盖可选
5. 非侵入式设计：仅创建符号链接，不修改原始文件结构
潜在局限
- 平台锁定：仅限 macOS，Windows/Linux 用户无法使用
- iCloud 依赖：需开启 iCloud Drive 且 Obsidian 使用 iCloud 同步模式
- 延迟风险：iCloud 同步存在网络延迟，极端情况下配置不同步
- 符号链接限制：部分文件系统或安全软件可能拦截 symlink 操作
- 单点故障：iCloud 服务中断将导致配置不可访问
适合人群
- 多苹果设备（Mac + iPad/iPhone）的 OpenClaw 重度用户
- 希望统一 work/personal 环境配置的数字游民
- 团队协作中需共享 workspace 模板的技术团队
常规风险
--overwrite操作不可逆，可能意外覆盖本地自定义配置- 多人同时编辑同一 iCloud 文件可能产生冲突
- 建议配合
status命令定期检查同步健康状态