claw-sync

核心用法

claw-sync 是 OpenClaw 生态专用的记忆与工作区备份同步工具，通过 Git 仓库实现跨设备数据同步。用户配置远程仓库地址和访问令牌后，可使用 /sync 推送记忆文件（MEMORY.md、USER.md、SOUL.md 等）及自定义技能到远程，或使用 /restore 拉取特定版本恢复工作区。工具支持版本标签管理（backup-YYYYMMDD-HHMM 格式）、恢复前自动创建本地备份，并提供 /sync-status 和 /sync-list 查看配置与历史版本。

显著优点

安全设计周全：强制 HTTPS 协议、限定 GitHub/GitLab/Bitbucket 主流平台、Token 格式与长度验证、错误信息自动脱敏，多重机制防止凭证泄露。明确排除 openclaw.json 和 .env 等含密钥文件，从源头阻断敏感信息外流。

灾难恢复可靠：每次恢复操作前自动创建本地备份，支持 --force 跳过确认但保留备份，降低误操作风险。版本化标签让用户可精准回滚到任意历史状态。

跨平台兼容：基于 Node.js 内置模块开发，零外部依赖，Windows/Mac/Linux 均可运行。

潜在缺点与局限性

配置门槛存在：需手动创建 .backup.env 文件并申请 Git 平台 Personal Access Token，对非技术用户不够友好。Token 以明文存储于本地文件，依赖用户自行保护文件权限。

平台限制严格：仅支持三大 Git 托管平台，自建 Git 服务器或企业私有平台无法使用。

无加密选项：备份文件以明文形式存储于远程仓库，若仓库被攻破则记忆内容完全暴露。

缺少审计日志：无内置操作记录，难以追踪谁在何时执行了同步或恢复。

适合的目标群体

• 多设备使用 OpenClaw 的个人开发者，需要保持工作区一致性
• 小团队协作场景，需安全共享记忆配置与自定义技能
• 重视数据安全、具备基础 Git 知识的进阶用户

使用风险

• Token 泄露风险：.backup.env 文件若被误提交或权限设置不当，可能导致仓库访问凭证暴露
• 恢复覆盖风险：--force 参数虽便捷，但跳过确认可能覆盖未备份的本地修改
• 网络依赖：同步完全依赖外部 Git 平台可用性，平台服务中断将影响备份恢复
• 性能瓶颈：大量历史版本或大型记忆文件可能导致 Git 操作变慢