核心用法
Elegant Sync 是一款面向 OpenClaw 用户的配置同步工具，通过 Git 实现多设备配置的版本化管理与备份。其核心工作流包括：首次配置环境变量（~/.openclaw/.backup.env 中的 BACKUP_REPO、BACKUP_TOKEN、INSTANCE_ID），执行 /sync 命令触发备份，以及通过 Git 分支切换实现跨设备恢复。
备份策略：采用「分支隔离」设计，每个设备拥有独立分支（如 omen16、macbook、opi5b），避免配置冲突；同时利用 .gitignore 规则自动排除敏感文件（.env、credentials/、openclaw.json 等），确保 API 密钥不上传至仓库。
恢复流程：在新机器上克隆仓库后，切换至目标分支并复制对应目录至 ~/.openclaw/workspace/，最后更新本地 INSTANCE_ID 完成迁移。
显著优点
- 安全优先设计：内置敏感信息过滤机制，默认排除密钥、凭证、日志等文件，降低泄露风险
- 多实例隔离：分支级隔离避免多设备配置互相覆盖，适合开发者拥有多台工作机的场景
- 版本可回溯：每次同步创建 Git tag，支持任意历史版本回滚
- 灾难恢复能力：自动本地备份 + 一键恢复流程，降低重装系统后的配置重建成本
- 最小侵入性：仅备份「记忆资产」（
workspace/memory/、AGENTS.md、SOUL.md等），不干扰运行态
潜在缺点与局限性
- Git 依赖：要求用户具备基础 Git 操作能力，且需维护私有仓库（GitHub/GitLab 等）
- Token 管理负担：
BACKUP_TOKEN仍需人工配置，若泄露则私有仓库暴露 - 无端到端加密：仓库内容以明文形式存储于 Git 服务商，依赖平台安全机制
- 冲突解决缺失：未提及分支合并策略，若多设备修改同一份配置可能需手动处理
- 媒体文件 exclusion：
media/被排除，用户需额外方案管理非文本资产
适合人群
- 拥有 2 台以上 OpenClaw 实例的进阶用户
- 重视「记忆资产」长期保存、愿意投入版本化管理成本的开发者
- 具备基础 Git 知识、拥有私有代码仓库的技术用户
常规风险
- Token 泄露：
ghp_xxx若写入 shell history 或被误提交，可导致仓库被非法访问 - 误操作覆盖：切换分支后若未确认当前实例，可能将 A 设备配置覆盖至 B 设备
- 服务商单点故障：Git 平台可用性直接影响恢复能力，建议配合本地冗余
- 隐私合规：
workspace/memory/可能含个人敏感信息，需确认私有仓库的访问权限设置