Clawdbot 专属备份升级套件，动态检测多代理工作区，支持一键备份/回滚与配置迁移，确保更新零风险。
说明：
## 核心用法
Clawdbot Update Skill 是一套面向多代理 AI 系统的运维工作流工具，专注于解决升级过程中的状态丢失与配置冲突问题。核心工作流分为三步：预览（Dry Run）→ 全量备份 → 增量更新/回滚。
**动态工作区检测**是最大亮点——脚本自动读取 `~/.clawdbot/clawdbot.json` 中的代理配置，无需手动指定路径即可备份任意数量的 agent workspace。执行 `backup-clawdbot-full.sh` 会生成带时间戳的备份目录，包含配置、凭证、会话状态、cron 任务及所有工作区压缩包；`restore-clawdbot.sh` 则支持一键还原至任意历史版本。
## 显著优点
1. **零配置开箱即用**：通过 jq 动态解析 JSON 配置，自适应单代理或多代理架构，新增 agent 无需修改脚本
2. **防御性设计**：强制 Dry Run 预览环节，提前暴露磁盘空间不足、路径缺失等风险
3. **Git 感知**：备份包含当前 commit hash，支持代码级回滚（`git checkout `）
4. **v2026.1.8 迁移指南**：内置 breaking changes 处理方案（DM Lockdown、allowlist 迁移、UTC 时间戳适配）
## 局限性与风险
– ** Bash 依赖**：要求目标系统预装 bash/jq/tar/git，Windows 原生环境需 WSL
– **非原子操作**：备份与更新分阶段执行，极端情况下（如备份后网关崩溃）可能产生状态分叉
– **凭证明文风险**：credentials 目录以 tar.gz 压缩存储，备份目录权限依赖系统 umask，建议配合全盘加密使用
## 适合人群
– 运行生产级 Clawdbot 多代理实例的运维者
– 需要频繁同步 upstream 的开发者
– 对「配置即代码」理念认同、能接受 jq 命令行操作的技术用户
## 常规风险
| 场景 | 等级 | 说明 |
|——|——|——|
| 备份期间网关运行 | 中 | 可能捕获不一致状态，建议先 `gateway stop` |
| 跨大版本还原 | 高 | v2026.1.8 前后配置格式不兼容，需手动执行 schema 迁移 |
| 自动化 CI 集成 | 低 | 脚本含交互式确认（如 doctor –yes），纯自动化需额外封装 |
会员专属
