概述
Clawdbot Update Skill 是一套专为多代理 AI 助手框架 Clawdbot 设计的更新运维工具集。核心功能围绕「备份-更新-验证-回滚」四阶段闭环展开，通过动态读取 ~/.clawdbot/clawdbot.json 自动识别所有代理工作区，无需手动维护路径列表。
核心用法
预览模式（零风险）
backup-clawdbot-dryrun.sh
输出待备份文件清单、预估容量及磁盘空间检查，不产生任何文件变更。
全量备份
backup-clawdbot-full.sh
打包配置、会话状态、凭据、定时任务、沙箱状态及所有工作区，输出至 ~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS/。
版本更新
跟随 UPDATE_CHECKLIST.md 执行：停止网关 → 拉取代码 → 适配破坏性变更（如 v2026.1.8 的 DM Lockdown 与沙箱作用域调整）→ 运行 doctor → 测试 → 守护进程启动。
紧急回滚
restore-clawdbot.sh <backup-dir>
支持完整配置、状态及工作区恢复，也可仅回退 git 版本。
显著优点
1. 动态工作区检测：告别硬编码路径，自动适应代理增减
2. 多代理原生支持：每个代理独立打包 workspace-<agent>.tar.gz
3. 安全优先设计：dry run → 备份 → 验证的三重保险机制
4. 版本化清单：附带 BACKUP_INFO.txt 与 git commit SHA，便于溯源
潜在局限
- 依赖 jq：要求系统预装 jq 以解析 JSON 配置
- 单节点备份：备份文件默认存储于本地
~/.clawdbot-backups/，未内置远程同步逻辑 - 破坏性变更需手动适配：如 v2026.1.8 的策略切换需用户执行 jq 命令修改配置，非全自动
- 网关停服窗口：更新流程需停止 gateway 服务，对高可用场景需配合负载均衡
适合人群
- 运行多代理 Clawdbot 实例的运维者
- 追求「可回滚」更新策略的谨慎型用户
- 需要维护 WhatsApp/Telegram/Discord 等多渠道接入的复杂配置场景
常规风险
| 风险点 | 缓解措施 |
|--------|----------|
| 备份期间磁盘空间不足 | dry run 预先检查 |
| 更新后配置不兼容导致网关启动失败 | `pnpm clawdbot doctor` 自动诊断 + 备份随时回滚 |
| OAuth token 过期 | 更新后执行 `pnpm clawdbot providers login` 重授权 |
| 沙箱隔离失效 | 验证 `sandbox.scope` 显式设置为 `"agent"` |
建议生产环境执行更新前，先将备份目录同步至异地存储（如 S3/rsync），避免本地磁盘故障导致备份与生产同时丢失。