必须将 OpenClaw 配置目录映射至 iCloud 可见路径实现跨设备实时同步：先创建 iCloud 专用目录，再验证 iCloud 同步就绪，接着清空本地缓存，最后通过软链接将配置路径重定向至 iCloud 托管位置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 macOS 上让 OpenClaw 的配置文件实现跨设备实时同步，必须绕过其默认写入本地沙盒的限制，将核心配置目录主动映射到 iCloud 可见路径，并确保所有设备读取同一份源——不能依赖 OpenClaw 自身的同步开关，它不提供 iCloud 集成能力。
iCloud 云端配置路径初始化
第一步：创建 iCloud 专用配置目录
执行 mkdir -p ~/Library/Mobile\ Documents/com~apple~CloudDocs/OpenClaw/config，该路径是 iCloud Drive 在 macOS 中唯一稳定可写的系统级挂载点，其他路径（如 iCloud 云盘根目录）在某些场景下会触发权限拒绝或同步中断。
第二步：确认 iCloud 同步已就绪
打开访达 → 侧边栏点击“iCloud 云盘”，检查是否可见“OpenClaw”文件夹；若不可见，说明 iCloud 云盘未启用或网络异常，【必须在此步验证成功后再继续】，否则后续软链将指向空路径。
第三步：停用 OpenClaw 并清空本地缓存
在菜单栏右上角点击 OpenClaw 图标 → “Quit OpenClaw”，再执行 rm -rf ~/Library/Application\ Support/OpenClaw；这一步不可跳过，否则旧配置会持续覆盖新同步路径，导致双端状态不一致。
符号链接接管配置目录
方法一：直接软链 Application Support 目录
运行 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/memoryln -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 分钟；
③ 在设备 B 上完全退出 OpenClaw（不是仅关闭窗口），重新启动，执行相同命令，对比 config/skills/ 下对应文件的修改时间与内容是否一致；
④ 若不一致，检查设备 B 的 iCloud 设置中是否勾选了“同步此 Mac”，且未启用“优化 Mac 存储空间”对 OpenClaw/config 目录做了“仅在线”标记——该功能会导致文件无法被 OpenClaw 读取。
