什么是clawsync
clawsync 是一个专为 OpenClaw 状态管理设计的 Git 优先备份、迁移与恢复工具，其核心理念是将 OpenClaw 的配置、工作区数据和敏感信息通过 Git 原生工作流进行安全归档与同步。它不依赖传统文件复制或云存储，而是利用 Git 的版本控制能力实现细粒度、可追溯的状态管理。用户可通过简单的命令行操作完成本地全量迁移、远程分支推送与拉取、以及跨机器的数据恢复，整个过程支持 dry-run 预览和预恢复快照等安全机制，最大限度降低误操作风险。此外，clawsync 还提供本地 HTTP 服务功能，允许在受令牌保护的环境下托管备份档案，便于团队内共享或临时访问。整体设计强调安全性与易用性并重，尤其适合需要频繁备份、跨平台迁移或协作恢复 OpenClaw 环境的开发者与运维人员。
核心功能特点
- 完整的 Git 原生工作流支持：提供 clawsync git init、push、pull 和 merge 命令，实现基于分支的备份与恢复
- 精细化的备份范围控制：支持 –include、–exclude、–ignore-paths 和 workspace-include-globs 参数，精准筛选需归档的内容
- 内置敏感数据脱敏管道：自动处理 secrets 占位符替换，并在恢复后提示用户执行环境变量恢复脚本
- 多策略恢复机制：支持 overwrite（覆盖）、skip（跳过）和本地优先 merge（合并），默认启用 dry-run 和安全检查
- 本地迁移归档与 HTTP 服务：可生成全量迁移包并启动带令牌的本地服务器，支持健康检查、上传下载与备份恢复接口
适用场景
clawsync 主要适用于需要长期维护 OpenClaw 项目状态的场景。例如，当开发者在多台设备间切换时，可通过 clawsync profile full-migrate 命令生成一个包含完整 workspace 和配置的迁移归档包，实现快速环境重建；若希望将备份集中管理，则可使用 clawsync git init 配合远程仓库，定期 push 当前状态到 Git 分支，形成历史版本链，便于回溯或团队协作。对于生产环境中的紧急恢复需求，clawsync unpack 命令可在本地解压归档并自动创建恢复前快照，确保原始数据不被覆盖。特别地，当涉及敏感凭证（如 gateway.auth.token）时，工具会主动保留本地 token 文件，避免因恢复导致认证失效。此外，企业用户还可部署 clawsync serve 服务，在内网中以 HTTPS 代理方式安全分发备份文件，既满足审计要求又提升协作效率。总之，无论是个人开发者还是中大型团队，只要涉及 OpenClaw 状态的持久化、迁移或灾备，clawsync 都能提供一套高效且安全的解决方案。