OpenClaw macOS跨系统同步：iCloud云端配置文件衔接实操【技巧】

要在 macOS 上实现 OpenClaw 配置跨设备实时同步，绕不开一个关键动作——把它的核心配置目录主动映射到 iCloud 可见路径上，而不是依赖 OpenClaw 自带的什么同步开关（它压根没有 iCloud 集成）。必须手动操作，让所有设备读取同一份源文件。

iCloud 云端配置路径初始化

执行 mkdir -p ~/Library/Mobile Documents/com~apple~CloudDocs/OpenClaw/config。这个路径是 iCloud Drive 在 macOS 上唯一稳定且可写的系统级挂载点——其他路径（比如 iCloud 云盘根目录）在特定场景下会触发权限拒绝或同步中断，所以别偷懒。

打开访达，侧边栏点击“iCloud 云盘”，检查是否能看到“OpenClaw”文件夹。看不到？那说明 iCloud 云盘没启用或者网络有问题。，否则后续创建的软链接将指向一个空路径，等于白忙活。

在菜单栏右上角点击 OpenClaw 图标 → “Quit OpenClaw”，然后执行 rm -rf ~/Library/Application Support/OpenClaw。这一步不可跳过——旧配置会持续覆盖新同步路径，导致双端状态不一致，到时候排查起来够你头疼的。

符号链接接管配置目录

运行 ln -sf ~/Library/Mobile Documents/com~apple~CloudDocs/OpenClaw/config ~/Library/Application Support/OpenClaw。这样 OpenClaw 启动时默认查找的配置路径，就被无缝重定向到了 iCloud 托管的位置。不需要改任何代码或启动参数，干净利落。

假设你只想同步记忆（Memory）和技能（Skills），而网关（Gateway）设置保持本地独立，可以分别执行：
ln -sf ~/Library/Mobile Documents/com~apple~CloudDocs/OpenClaw/config/memory ~/Library/Application Support/OpenClaw/memory
ln -sf ~/Library/Mobile Documents/com~apple~CloudDocs/OpenClaw/config/skills ~/Library/Application Support/OpenClaw/skills
有一点要注意：skills 目录里如果包含 .py 文件，必须确保所有设备的 Python 环境版本一致，否则加载时会报错。

多设备首次同步验证

① 在设备 A 上重启 OpenClaw，打开终端执行 openclaw --status，确认输出中显示 Config path: /Users/xxx/Library/Mobile Documents/com~apple~CloudDocs/OpenClaw/config。

② 修改一个 Skill 的描述字段（比如把 “web_search” 改为 “web_search_v2”），保存后等上 2–3 分钟，给 iCloud 一点同步时间。

③ 在设备 B 上完全退出 OpenClaw（不是只关闭窗口），重新启动，执行相同命令，对比 config/skills/ 下对应文件的修改时间和内容是否一致。

④ 如果发现不一致，检查设备 B 的 iCloud 设置里有没有勾选“同步此 Mac”，有没有启用“优化 Mac 存储空间”对 OpenClaw/config 目录做了“仅在线”标记——这个功能会导致文件无法被 OpenClaw 读取，是一个很容易被忽略的坑。