跨平台同步未生效需五步修复：一、统一挂载远程存储路径；二、同步认证凭证；三、启用gateway远程协调模式；四、通过nas构建中间状态数据库；五、配置统一消息通道与设备标识。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在手机和电脑上分别安装OpenClaw，但两者任务状态不一致、历史记录无法延续、指令在一台设备发出后另一台无法响应，则说明跨平台同步尚未生效。以下是实现手机与电脑无缝衔接的AI体验的具体操作路径：
一、统一挂载远程共享存储路径
OpenClaw默认将每个设备的会话、状态和笔记分散保存在本地~/.openclaw/agents/子目录中，导致跨设备无法识别历史上下文。必须将所有Agent指向同一远程存储位置，使数据源物理一致。
1、在阿里云OSS或腾讯云COS中新建私有存储桶，设置读写权限仅限主账号；
2、在手机（需Termux）及电脑上均安装rclone工具，并配置该存储桶为远程后端，命名为claw-sync；
3、分别在手机Termux与电脑终端执行挂载命令：rclone mount claw-sync:openclaw-data ~/.openclaw/shared --vfs-cache-mode writes &；
4、修改各端Agent的SOUL.md文件，在stateDirectory字段中统一填写~/.openclaw/shared/state/；
5、重启手机Termux中的Agent服务与电脑端npm run start进程，验证~/.openclaw/shared/state/下是否同步生成auth-profiles.json及对应设备子目录。
二、同步认证凭证（Cookie与Token）
微信公众号、知乎、iMessage等平台的登录态依赖本地Cookie文件或API密钥，若各端凭证孤立存放，将出现“已登录但无法发稿”或“消息发送失败”现象。必须集中管理并动态注入敏感凭证。
1、将手机Termux中~/storage/shared/openclaw/auth/weixin.json与电脑端~/.openclaw/agents/pc/auth/zhihu.json全部迁移至~/.openclaw/shared/auth/目录；
2、在各端agent/auth-profiles.json中，将cookieFile字段路径统一改为相对~/.openclaw/shared/auth/的路径，例如"weixin.json"；
3、对百炼API-Key、飞书AppSecret等密钥类凭证，禁用硬编码，改用环境变量注入：在手机Termux的~/.bashrc与电脑~/.bash_profile中分别添加export OPENCLAW_API_KEY=$(cat ~/.openclaw/shared/keys/api-key)；
4、确保~/.openclaw/shared/keys/目录权限严格设为600，执行chmod 600 ~/.openclaw/shared/keys/*；
5、重启手机Termux中的Agent服务与电脑端npm run start进程，验证~/.openclaw/shared/state/下是否同步生成auth-profiles.json及对应设备子目录。
三、启用Gateway远程协调模式
OpenClaw采用网关（Gateway）与节点（Node）分离架构，仅当Gateway处于远程可访问状态时，手机与电脑才能被识别为同一协同网络中的分布式节点，从而实现指令路由与状态广播。
1、在电脑端执行openclaw gateway --mode=remote --port=8080启动网关服务；
2、确认防火墙放行8080端口，并在路由器中配置端口转发规则，将外部请求映射至该电脑内网IP；
自动备份 OpenClaw 整体配置到远程存储（支持任意 rclone 后端：COS、S3、FTP、SFTP、WebDAV等）。 触发场景： - 创建/配置自动备份任务 - 设置备份周期、保留份数、目标目录 - 手动触发备份 - 查看/恢复备份 - OpenClaw 运行异常时的提醒
3、在手机Termux中运行openclaw node register --gateway http://[电脑局域网IP]:8080 --role=mobile完成配对；
4、使用openclaw node list命令检查两台设备是否同时出现在活跃节点列表中；
5、向微信Bot发送测试指令“同步当前任务列表”，观察手机与电脑端是否同时更新相同任务状态。
四、通过NAS构建中间状态数据库
当设备间网络不稳定或存在NAT隔离时，直接P2P同步易失败。引入NAS作为持久化状态中继，可绕过连接限制，确保CRDTs同步算法稳定运行。
1、在群晖DS220+等NAS上启用MariaDB服务，创建数据库openclaw_sync；
2、在电脑与手机Termux中分别配置~/.openclaw/config.json，添加"database": {"type": "mysql", "host": "192.168.1.100", "user": "claw", "password": "******", "db": "openclaw_sync"}；
3、执行openclaw sync init在数据库中初始化CRDT表结构；
4、在各端启动Agent前，先运行openclaw sync pull强制拉取最新状态快照；
5、验证SELECT COUNT(*) FROM crdt_state_log返回值在两端一致，且时间戳最新条目相差不超过3秒。
五、配置统一消息通道与设备标识
OpenClaw依赖消息通道识别指令来源设备类型，并据此调度对应技能。若未显式声明设备角色，系统将默认按本地环境推断，导致移动端误调用桌面级GUI操作技能。
1、在手机Termux中编辑~/.openclaw/identity.json，写入{"device_id": "mobile-7a2f", "platform": "android", "capabilities": ["camera", "sms", "notification"]}；
2、在电脑端~/.openclaw/identity.json中写入{"device_id": "pc-d9e1", "platform": "windows", "capabilities": ["filesystem", "clipboard", "desktop_capture"]}；
3、确保两文件中device_id字段值全局唯一，且不包含特殊字符；
4、在SOUL.md中启用contextAwareRouting: true参数；
5、发送指令“用手机拍张照传到电脑桌面”，观察AI是否调用手机摄像头技能而非尝试在PC端打开相机应用。
