cross-device-sync

🔄 GitHub驱动的跨端记忆同步

🥥22总安装量 6评分人数 6
100% 的用户推荐

基于GitHub仓库实现OpenClaw跨设备记忆同步,支持双向同步与冲突处理,适合多设备用户保持数据一致性。

B

存在边界风险,建议在隔离环境中验证

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ⚠️ 检出命令注入漏洞::`repoUrl` 未经充分验证直接拼接到 `exec` 命令中,存在中等严重程度风险
  • ⚠️ 敏感信息处理不当:GitHub Personal Access Token 通过命令行输入,可能被 shell 历史记录捕获
  • ⚠️ 不安全的文件删除操作:使用 `rm -rf` 而非 Node.js 原生 `fs.rmSync` 清理临时目录
  • ✅ 网络活动目标明确:所有网络请求均指向 GitHub 服务器,无异常外联行为
  • ✅ 文件系统访问范围合理:主要限制在工作区和 GitHub 目录,未越权访问系统关键路径

使用说明

核心用法

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 版本兼容性。

cross-device-sync 内容

手动下载zip · 9.5 kB
clawhub.jsonapplication/json
请选择文件