核心用法
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 重复将覆盖他人配置;建议采用 用户名-主机名 命名规范。