ClawdBot官方配置备份与迁移工具,支持自动化备份、Git版本控制、多设备同步,开发者必备基础设施
说明:
## 核心用法
ClawdBot Backup Skill 是一套完整的配置备份解决方案,通过命令行工具实现 ClawdBot 目录(`~/.claude/`)的备份、恢复与同步。支持三种备份粒度:完整备份(skills/commands/settings/mcp/contexts/templates)、仅技能备份、仅设置备份。提供 tar 归档、Git 版本控制、rsync 云端同步三种核心机制。
### 显著优点
1. **分层备份策略**:明确区分 ESSENTIAL(技能/命令/设置/MCP)、RECOMMENDED(上下文/模板)、OPTIONAL(本地配置/缓存)三级备份范围,避免冗余
2. **多场景覆盖**:包含快速手动命令、全功能 Bash 脚本(支持 stats/cleanup/restore 子命令)、Git 工作流、rsync 跨设备同步、定时自动化(cron/systemd/launchd)完整工具链
3. **迁移友好**:专门针对换机场景设计,提供从备份文件恢复、Git 克隆、单技能导出/导入三种迁移路径
4. **安全设计**:`.gitignore` 模板自动排除 `settings.local.json` 等机器敏感配置,防止配置冲突
### 潜在缺点与局限
– **无加密机制**:备份文件为明文 tar.gz,敏感 MCP 密钥、API 配置若未单独处理存在泄露风险
– **无内置去重**:依赖外部工具(如 restic/duplicity)实现增量备份,原生方案为全量归档
– **跨平台差异**:systemd/launchd/cron 三种定时方案需用户根据操作系统手动选择配置
– **权限依赖**:恢复操作使用 tar 直接覆盖 `~/.claude`,需确保无运行中的 ClawdBot 进程占用文件
### 适合人群
– 多设备开发需同步配置的技术用户
– 团队协作需共享 skills 的开发者
– 重视配置版本控制、习惯 Git 工作流的工程师
### 常规风险
– **覆盖风险**:restore 命令默认覆盖现有配置,脚本虽含确认提示但自动化场景需谨慎
– **敏感数据泄露**:备份含 MCP `servers.json`,若推送至公共 Git 仓库可能暴露 API 密钥
– **归档损坏**:长期存储的 tar.gz 需定期验证(`tar -tzvf`),文档已提供完整性检查方法但需用户主动执行








