同步失败主因是rclone mount未运行或stateDirectory路径错误：需检查挂载进程、日志报错，确认stateDirectory指向统一共享路径（如~/.openclaw/shared/state/），且权限严格设为700/600。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
同步失败不是配置没生效，而是远程存储挂载或路径指向出了偏差——90% 的 case 都卡在 rclone mount 没跑起来，或者 stateDirectory 指错了位置。
检查 rclone 挂载是否真正就绪
OpenClaw 多端同步依赖 rclone mount 把云存储（如阿里云 OSS）映射成本地路径，但这个进程容易静默退出或卡住。
- 运行
ps aux | grep rclone，确认有类似rclone mount claw-sync:openclaw-data ~/.openclaw/shared --vfs-cache-mode writes的进程在运行；没有？说明挂载失败或已崩了 - 手动执行挂载命令，加
--log-file /tmp/rclone-mount.log --log-level INFO查日志，常见报错是failed to open bucket（OSS/Bucket 权限不对）或port already in use（--vfs-cache-mode writes用了默认 fuse 端口被占） - 不要用
nohup启动，要用&+disown或 systemd service 管理，否则终端关闭后挂载自动卸载
验证 stateDirectory 是否指向共享路径
AionClaw 默认每个 Agent 写自己的 ~/.openclaw/agents/*/state/，必须显式改到统一目录，否则数据还是各自为政。
- 打开对应 Agent 的
SOUL.md，确认stateDirectory字段值是~/.openclaw/shared/state/（注意结尾斜杠不能少） - 不要写成相对路径如
../shared/state/，AionClaw 不做路径展开，会直接创建空目录 - 检查该路径下是否有
auth-profiles.json和session-history/子目录：没有？说明 Agent 根本没写进去，大概率是stateDirectory拼写错误或权限拒绝（比如~/.openclaw/shared属于 root）
同步凭证和密钥时的权限陷阱
Cookie 文件、API Key 这类敏感数据一旦权限过宽，AionClaw 会主动拒绝加载，报错不明确，只显示“同步失败”或“认证不可用”。
- 所有存凭证的目录（如
~/.openclaw/shared/auth/、~/.openclaw/shared/keys/）必须设为700或600，运行ls -ld ~/.openclaw/shared/auth看输出里有没有drwx------ - 凭证文件本身也要
600，比如weixin.json不能是-rw-r--r--，否则 AionClaw 启动时跳过加载 - 环境变量注入方式必须用
export OPENCLAW_API_KEY=$(cat ~/.openclaw/shared/keys/api-key)，不能写死在配置里，也不能用source加载 —— AionClaw 的启动脚本不读 shell profile
Git 同步技能插件时的软链接失效问题
全局技能目录 ~/.openclaw/skills 如果用 Git 管理，本地 skills/ 目录又用软链接指向它，很容易因 Git 切分支、pull 冲突导致链接断开。
- 进任意 Agent 目录，运行
ls -l skills，输出应为skills -> ~/.openclaw/skills；如果是skills -> ../.openclaw/skills或显示broken，说明链接损坏 - 修复命令就是
rm -rf skills && ln -s ~/.openclaw/skills skills，别用绝对路径拼接，避免跨用户或容器环境出错 - Git pull 后记得
kill -SIGHUP $(pgrep -f 'openclaw start')，否则旧进程还在读缓存里的 skill 列表，新插件不会生效
最常被忽略的一点：同步不是“配完就通”，而是一次性打通存储挂载、路径指向、权限控制、进程重载四个环节。少一个，AionClaw 就当它不存在——它不会报错，只会安静地继续用本地私有副本。
