概述
Clawdbot Update Skill 是一套面向 Clawdbot 多 Agent 部署场景的完整备份、更新与恢复工作流。该技能通过动态读取配置文件实现多工作区自动检测，覆盖配置、会话状态、凭证、定时任务及沙箱环境等全部关键数据，并提供 Dry Run 预览、完整备份、安全回滚三大核心能力。
核心用法
备份流程：先运行 backup-clawdbot-dryrun.sh 预览影响范围与磁盘空间需求，确认无误后执行 backup-clawdbot-full.sh 生成时间戳备份目录。备份内容自动包含 ~/.clawdbot/ 下的配置、会话、凭证、沙箱及所有 Agent 工作区。
更新流程：遵循 UPDATE_CHECKLIST.md 执行标准化步骤——备份 → 停止网关 → 拉取最新代码 → 处理破坏性变更 → 运行 doctor 检测 → 功能验证 → 守护模式启动。
回滚流程：若更新后异常，执行 restore-clawdbot.sh <备份目录> 可一键还原全部配置、状态与工作区，或手动结合 git checkout 实现版本级回退。
显著优点
1. 动态多 Agent 支持：自动解析 clawdbot.json 识别任意数量的 Agent 工作区，无需硬编码路径
2. 零风险预览：Dry Run 模式完整展示备份范围与预估大小，零副作用
3. 原子级安全回滚：完整保留 git 状态、配置快照与工作区压缩包，支持分钟级恢复
4. 破坏性变更指引：内置 v2026.1.8 等重大版本迁移说明，降低升级风险
5. 模块化脚本设计：校验、检测、备份、恢复职责分离，便于 CI/CD 集成
潜在局限
- 依赖
~/.clawdbot/clawdbot.json存在且格式正确，若主配置损坏则动态检测失效 - 需手动处理代码层面的破坏性变更（如 DM 策略、沙箱作用域调整），技能仅提供示例命令
- 未内嵌自动化测试套件，功能验证步骤仍需人工执行 checklist
- 恢复脚本默认覆盖现有配置，无交互式确认，误操作风险需通过备份策略规避
适合人群
- 运行多 Agent Clawdbot 实例的进阶用户与系统管理员
- 需要保障生产环境高可用、追求可回滚更新策略的团队
- 熟悉 shell 脚本与 git 工作流、具备基础 jq/CLI 操作能力的技术人员
常规风险
- 配置覆盖风险：restore 脚本直接替换运行中配置，需在网关停止状态下执行
- 版本兼容性：跨大版本更新时若跳过 doctor 检测或配置迁移，可能导致网关启动失败
- 存储空间：完整备份包含所有工作区数据，高频更新需监控
~/.clawdbot-backups/磁盘占用 - 凭证安全：备份包含
credentials/目录，需确保备份目录权限（建议 700）及传输加密