Elegant Sync

🔄 配置云端无忧同步 · 版本可控安心备份

基于 Git 的 OpenClaw 配置安全同步工具,支持版本化备份、.gitignore 规则过滤、多实例管理,确保敏感信息零泄露。

收藏
2.7k
安装
1.1k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Elegant Sync 是一款专为 OpenClaw 设计的配置同步工具,通过 Git 版本控制实现跨设备配置管理。用户通过 /sync 命令将工作区配置(memory、skills、identity 等)推送至私有 GitHub 仓库,支持 --dry-run 预览、--selective 选择性同步及自动版本标签。恢复时通过 /restore 从远程拉取指定实例备份,配合本地自动备份机制实现灾难恢复。

显著优点

安全优先设计:内置敏感文件黑名单(.env、openclaw.json、credentials/ 等),结合 .gitignore 规则双重过滤,确保 API 密钥零上传;Token 错误信息脱敏、路径遍历防护、URL 白名单(仅限 GitHub/GitLab)等机制构建纵深防御。

版本化管理:每次同步自动生成 backup-YYYYMMDD-HHmm 标签,支持任意历史版本回滚,解决传统覆盖式备份的不可逆问题。

多实例原生支持:通过 INSTANCE_ID 区分不同机器(opi5b/macbook/vps-1 等),单仓库管理多设备配置,新机器部署时仅需克隆仓库并复制对应实例目录。

无缝集成体验:命令语义清晰(/sync /restore /status),自动检测首次配置并引导用户创建 .backup.env,降低上手门槛。

潜在局限

依赖外部 Git 托管:强制依赖 GitHub/GitLab 私有仓库,对隐私极度敏感用户或离线环境不够友好;未内置端到端加密,依赖平台自身安全。

手动密钥迁移:恢复后需手动重新配置 API keys(.env),无法实现真正的"一键全量恢复",跨设备迁移时仍需人工介入敏感信息。

Git 历史累积风险:长期版本化备份可能导致仓库体积膨胀;敏感文件若误加入白名单,历史提交难以彻底清除。

适合人群

  • 多设备使用 OpenClaw 的技术用户
  • 重视配置版本历史与可回滚能力的开发者
  • 具备基础 Git 操作能力的进阶用户
  • 愿意以私有仓库信任 GitHub/GitLab 安全模型的用户

常规风险

1. Token 泄露风险BACKUP_TOKEN 以明文存储于本地 .backup.env,若设备被入侵可直接读取;建议配合系统密钥管理服务(macOS Keychain/ Linux libsecret)使用。
2. 误配置风险:用户自定义 .gitignore 规则可能意外排除重要配置,或包含敏感文件;建议首次同步后人工检查远程仓库内容。

3. 远程仓库单点故障:GitHub 服务中断或账号封禁将导致配置无法恢复;建议定期 git clone --mirror 做异地冷备份。

4. 实例 ID 冲突:多用户共享仓库时若 INSTANCE_ID 重复将覆盖他人配置;建议采用 用户名-主机名 命名规范。

Elegant Sync 内容

手动下载zip · 6.8 kB
index.jstext/javascript
请选择文件