openclaw帮助中心
深入了解引擎底层的跨设备同步原理。通过解析局域网协同触发条件、账号验证流程及数据冲突的自动化处理策略，帮助您构建清晰的预期，从容应对多端协同中的复杂网络环境。
前置判断与路由选择
基于网络环境的动态探测，自动为您选择最优的数据交换通道。
局域网协同触发条件
为了最大化传输效率并保障数据隐私，openclaw 优先尝试建立局域网直连。该机制依赖于多播 DNS (mDNS) 进行设备发现。触发此通道需要满足以下硬性条件：
- 设备需处于同一子网内，且路由器未开启“AP隔离”功能。
- 防火墙规则允许 openclaw 进程进行本地端口通信。
- 设备登录了相同的加密凭证体系。
当上述条件不满足或设备处于跨地域网络时，系统将无缝降级至安全的 WebSockets 云端同步通道，确保协同不中断。
数据冲突的自动化处理策略
在离线转在线、或多端高频并发修改的场景下，数据版本分歧不可避免。openclaw 采用混合型冲突解决策略来保障数据一致性：
- 时间戳与逻辑时钟： 底层通过向量时钟记录每次操作的历史轨迹，精准判断修改的先后顺序。
- 自动合并原则： 对于非结构化文本，默认采用“最后写入者胜出 (LWW)”策略自动覆盖；对于复杂配置项，则尝试进行无损合并。
- 边界保护： 当系统无法安全判定合并意图时，将主动中止覆盖行为，生成并行的冲突副本，并在界面上提示用户手动裁决。如果遇到此类情况，建议参考 排查文档openclaw 获取处理建议。
同步状态与账号验证 FAQ
针对日常使用中关于多设备登录与状态验证的核心疑问解答。
多设备登录时，账号验证流程是怎样的？
当新设备尝试接入同步网络时，需通过主设备的授权确认或云端主密码验证。验证通过后，设备会获取具备时效性的加密令牌。在离线模式下，设备依靠本地缓存的令牌维持基础编辑权限，直到下一次网络连接时重新校验。
如何判断当前是云端同步还是局域网直连？
您可以通过客户端底部的状态指示灯进行判断。绿色实心图标代表已建立局域网直连通道，延迟极低；蓝色图标则表示当前正在通过安全的云端服务器进行中转同步。
离线编辑后恢复网络，发现部分数据丢失？
这通常是因为另一台设备在您离线期间对同一数据块进行了更高优先级的修改。openclaw 默认保留最新时间戳的操作。若需找回历史记录，可通过本地的“历史版本快照”功能进行回溯提取。
同步引擎是否会限制接入的设备数量？
底层同步协议本身不对节点数量设限，但实际允许同时在线协作的设备上限受限于您当前账号类型的配额策略。超出限制时，最早处于非活跃状态的设备将被自动暂停同步。
为什么在切换网络环境后，同步会短暂暂停？
网络切换（如从 Wi-Fi 切换至蜂窝网络）会导致 IP 地址变更。此时，openclaw 的底层引擎需要主动断开旧连接，重新探测路由路径并握手验证。此过程通常在数秒内自动完成，属于保障数据传输安全的正常熔断机制。