核心用法
cross-device-sync 是专为 OpenClaw 设计的跨设备记忆同步技能，以 GitHub 私有仓库作为中央存储枢纽，实现多台设备间的记忆文件双向同步。用户通过 setup_cross_device_sync 完成初始化配置，输入 GitHub 仓库地址和个人访问令牌后，技能自动创建同步脚本并配置工作目录。日常使用中，，sync_now 执行即时双向同步——先从远程拉取最新更改，合并本地修改后再推送至云端；check_sync_status 则用于验证连接状态、检查脚本完整性及报告配置信息。此外，技能支持自动化定时同步选项，减少手动操作负担。
显著优点
该技能的最大优势在于依托 GitHub 成熟的版本控制基础设施，无需自建服务器即可实现可靠的跨设备同步。Git 原生的冲突处理机制为数据一致性提供了坚实保障，用户可通过提交历史追溯变更。双向同步设计确保任何设备上的更新都能及时传播，配合私有仓库设置，兼顾便利性与数据隐私。自动化脚本生成降低了技术门槛，非专业用户也能快速完成配置。
潜在缺点与局限性
技能存在明显的安全隐患：：repoUrl 参数未经严格验证直接拼接到 shell 命令中，存在命令注入风险；敏感令牌通过命令行输入可能被 shell 历史记录捕获。功能层面，同步依赖网络连接和 GitHub 服务可用性，离线场景下无法同步；大文件或频繁同步可能触发 GitHub API 速率限制。此外，技能未提供图形化界面，纯命令行交互对新手不够友好，且缺乏内置的加密机制，仅依赖 GitHub 的私有仓库保护数据。
适合的目标群体
主要面向需要在 2-4 台设备间同步 OpenClaw 记忆文件的用户，如同时使用办公电脑、家用笔记本和移动设备的职场人士。适合已熟悉 Git 基础操作、拥有 GitHub 账户的技术用户，以及对数据隐私有要求、不愿使用第三方云同步服务的隐私敏感型用户。不适合完全无技术背景、或需要实时高频同步的协作场景。
使用风险
除安全报告指出的命令注入和敏感信息泄露风险外，常规使用中还应注意：Git 合并冲突时需手动解决，可能产生数据覆盖；长期未同步的设备可能出现大量冲突；依赖 fs-extra 但实际使用原生 fs 模块，存在轻微维护不一致风险；rm -rf 命令虽作用于临时目录，仍建议关注 Node.js 版本兼容性。