Clawdbot Backup

核心用法

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），文档已提供完整性检查方法但需用户主动执行

核心用法

ClawdBot Backup Skill 是一套完整的配置备份与恢复解决方案，专为ClawdBot用户设计。核心功能涵盖：

• 多模式备份：支持full（完整备份）、skills（仅技能）、settings（仅设置）三种粒度
• 版本控制集成：原生Git工作流，支持.gitignore过滤机器敏感配置
• 跨设备同步：rsync双向同步、云端目录映射、Git仓库克隆三种迁移方案
• 自动化运维：Cron定时任务、Systemd Timer、macOS Launchd全覆盖

使用示例

# 快速完整备份
tar -czvf ~/clawdbot-backup.tar.gz -C ~/.claude skills commands settings.json

# Git版本管理
cd ~/.claude && git add . && git commit -m "daily backup"

# 跨机同步
rsync -avz --delete ~/.claude/skills/ user@server:~/clawdbot-backup/

---

显著优点

| 维度 | 亮点 |

|------|------|

| **零依赖风险** | 纯Markdown文档型Skill，无可执行代码，规避供应链攻击 |

| **结构清晰** | ESSENTIAL/RECOMMENDED/OPTIONAL三级备份策略，避免冗余 |

| **场景覆盖全** | 从个人单机备份到团队协作Gitflow，再到企业级Systemd托管 |

| **可审计性** | 内置`stats`子命令量化技能数量与目录体积，便于容量规划 |

| **安全默认值** | 自动排除`settings.local.json`等机器敏感文件，防止配置泄露 |

---

局限性与注意事项

1. T3来源可信度：GitHub仓库clawdbot/backup-skill无法实时验证，需人工确认仓库活跃度
2. 无内置加密：备份文件为明文tar.gz，敏感项目建议配合gpg或age加密
3. rsync覆盖风险：--delete标志可能意外清除目标端独有文件，建议首次同步使用--dry-run
4. Git冲突未自动化：多设备并行修改可能引发合并冲突，需手动解决
5. 跨平台路径假设：示例脚本硬编码~/.claude路径，Windows用户需适配%USERPROFILE%

---

适合人群

| 用户类型 | 推荐方案 |

|----------|----------|

| 个人开发者 | 本地tar备份 + 每日Git提交 |

| 多设备用户 | GitHub私有仓库 + `auto-commit`脚本 |

| 团队协作者 | 组织级Git仓库 + 分支策略（禁止直接push main） |

| 高级运维 | Systemd Timer + 异地rsync + 备份完整性校验 |

---

常规风险

• 权限风险：恢复操作使用-C $HOME可能覆盖现有配置，脚本已内置y/N交互确认
• 存储膨胀：默认保留10份历史备份，长期运行需关注磁盘空间
• Token泄露：若mcp/servers.json包含API密钥，Git备份时需确认.gitignore已正确配置
• 误操作恢复：restore命令无撤销机制，建议恢复前先备份当前配置

> ⚠️ 关键提示：文档明确建议"A backup you can't restore is worthless"，强调每季度测试恢复流程的必要性。