核心功能与用法
obsidian-openclaw-sync 是一款专为 macOS 设计的 OpenClaw 配置同步工具，解决多设备环境下 AI Agent 配置无法同步的核心痛点。该技能通过创建符号链接（symlink）将本地 Obsidian 库与 iCloud Drive 打通，实现配置文件的自动云端同步。
典型使用流程
1. 状态检查：运行 /obsidian-openclaw-sync status 查看所有 iCloud 库及其 OpenClaw 配置状态
2. 初始化同步：执行 setup 命令，交互式选择目标库，自动创建 assets/、skills/、projects/、team/ 等关键目录的符号链接
3. 多设备配置：在第二台设备使用 setup --overwrite 将本地 openclaw.json 替换为 iCloud 版本 symlink
4. 日常同步：iCloud Drive 自动处理文件变更，无需手动干预
显著优点
- 零配置同步：完全依赖 macOS 原生 iCloud Drive，无需第三方服务
- 多工作空间支持：自动识别
workspace_*和workspace-*命名模板 - 安全回退机制：
unset命令可查看并移除所有本地符号链接 - 智能检测：自动扫描 iCloud Obsidian 目录，识别有效库（含
.obsidian/）与无效库 - 细粒度控制：支持
--vault预选择、--overwrite强制覆盖、--no-confirm自动化部署
局限性与风险
| 方面 | 说明 |
|------|------|
| **平台锁定** | 仅支持 macOS，依赖 Apple iCloud 生态，Windows/Linux 用户无法使用 |
| **前置依赖** | 必须预先配置 Obsidian iCloud 同步，否则无法检测库 |
| **冲突处理** | 未明确处理 iCloud 与本地文件的并发修改冲突，依赖 iCloud 原生冲突策略 |
| **权限要求** | 需要文件系统读写权限及 iCloud Drive 访问权限 |
| **覆盖风险** | `--overwrite` 模式会直接替换本地 `openclaw.json`，可能造成配置丢失 |
适合人群
- 使用 macOS + iCloud + Obsidian 组合的多设备用户
- 需要 团队协作同步 OpenClaw 配置 的开发者或团队
- 拥有 多 Agent 工作空间 且追求配置一致性的高级用户
常规风险提醒
- 备份建议：首次使用
--overwrite前务必备份本地openclaw.json - 网络依赖：iCloud 同步延迟可能导致跨设备配置短暂不一致
- 隐私注意：配置数据流经 Apple iCloud，敏感项目需评估合规性