必须统一远程存储并重定向数据路径：先用rclone挂载阿里云oss或syncthing点对点同步至~/.aionclaw/shared，再修改config.json的sharedstateroot及各agent的soul.md中三项目录指向该共享路径，最后重启验证三端会话、技能与认证状态一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Mac、Windows和手机端同时使用AionClaw智能体并保持会话历史、技能配置和认证状态一致，必须打破默认的本地隔离存储机制，手动建立统一数据源路径与同步通道。
确认同步前提与设备准备
确保所有设备已安装 AionClaw 3.1.0 或更高版本，并运行在同一局域网内；主控设备（推荐设为Mac或Windows台式机）需具备24小时开机能力，且已安装 rclone 工具（v1.65+）及具备SSH访问权限。手机端需通过WebUI模式接入，不支持直接安装独立App。
检查各设备时间是否同步：执行 date 命令，误差超过3秒将导致CRDTs同步冲突，【务必用NTP服务校准】。
挂载统一远程存储为共享根目录
方法一：使用阿里云OSS私有桶（推荐稳定性）→ 在OSS控制台新建私有Bucket，名称设为 aionclaw-sync-你的域名缩写，地域选华东1（杭州）；→ 执行 rclone config 添加新远程，type = s3，provider = Aliyun，填入主账号AK/SK；→ 运行挂载命令：rclone mount aionclaw-sync:state ~/.aionclaw/shared --vfs-cache-mode writes --daemon；→ 验证挂载成功：ls -l ~/.aionclaw/shared 应返回空目录但无报错。
方法二：Syncthing点对点直连（免云依赖）→ 在主控设备安装 Syncthing v1.27+，启动后访问 http://127.0.0.1:8384 → 新建文件夹，路径设为 ~/.aionclaw/shared，共享给其他设备ID；→ 其他设备添加同一文件夹，选择“仅下载”模式，避免双向覆盖风险；→ 启动同步后，观察右上角状态图标变为绿色实心圆点即生效。
重定向AionClaw核心数据路径
第一步：关闭所有AionClaw进程，包括后台服务与WebUI；
第二步：备份原配置：cp -r ~/.aionclaw ~/.aionclaw.bak-$(date +%s)；
第三步：编辑全局配置文件 ~/.aionclaw/config.json，定位到 "sharedStateRoot" 字段，将其值修改为绝对路径 "/Users/xxx/.aionclaw/shared"（Mac）或 "C:\Users\xxx\.aionclaw\shared"（Windows），注意反斜杠转义；
第四步：进入每个Agent所在目录（如 ~/.aionclaw/agents/agent-webhook），打开其 SOUL.md 文件，将 stateDirectory、authDirectory、skillsDirectory 三项全部指向 ~/.aionclaw/shared/{state,auth,skills} 子路径；
第五步：重启服务：aionclaw restart --force，等待终端输出 "Gateway online, 3 agents synced" 类似提示。
验证跨平台同步状态
在Mac端新建一个会话，发送消息“测试同步”，观察左侧会话列表是否立即出现新条目；
切换至Windows客户端，刷新界面，该会话应自动出现在顶部，且消息时间戳与Mac端完全一致；
用手机浏览器访问 http://[主控设备IP]:8080/webui，输入同一账号密码，进入后点击「对话任务」→ 查看历史记录，确认该会话可见且可继续回复；
若任一端未显示，请立即检查 ~/.aionclaw/shared/state/ 下是否存在对应 agent-xxx/session-xxxxx.json 文件，【缺失即说明挂载失败或路径未生效】。
