核心用法
Clawdbot Update Skill 是一套完整的系统维护工作流工具，专为 Clawdbot 多代理平台设计。其核心功能围绕三个关键场景展开：备份预览（Dry Run）、完整备份与安全恢复。用户可通过 backup-clawdbot-dryrun.sh 在零风险环境下预览备份内容，包括文件清单、预估大小及磁盘空间检查；确认无误后执行 backup-clawdbot-full.sh 创建包含配置、会话状态、凭证、定时任务、沙箱状态及动态检测到的所有代理工作区的完整备份。恢复时，，restore-clawdbot.sh 支持一键回滚至任意历史版本，并保留 Git 版本追踪能力。
该 Skill 的差异化能力在于动态工作区检测——自动解析 ~/.clawdbot/clawdbot.json 中的 .routing.agents 配置，识别任意数量的代理工作区，无需手动维护路径列表。配合 check-upstream.sh 更新检查与 validate-setup.sh 配置验证，形成从更新预警、备份、升级测试到紧急回滚的闭环工作流。
显著优点
1. 零误操作设计：干运行模式让用户在创建实际备份前完整预览影响范围，避免意外覆盖或空间不足导致的失败。
2. 多代理原生支持：动态检测机制完美适配复杂的多代理部署场景，无论代理数量如何变化，备份范围始终准确。
3. 安全回滚保障：完整的配置+状态+代码版本三重备份，确保升级失败时可秒级恢复至稳定状态。
4. 透明可信：MIT 开源协议，代码无混淆，作者 Pascal Schott 为 Clawdbot 官方生态贡献者，身份可验证。
5. 生产级细节：包含更新检查清单、快速参考手册、破坏性变更预警（如 v2026.1.8 的 DM Lockdown 策略调整），降低运维认知负担。
潜在缺点与局限性
1. 备份未加密：备份文件以 tar.gz 形式明文存储于 ~/.clawdbot-backups/，依赖文件系统权限保护，若多用户共享系统或备份同步至云端，存在凭证泄露风险。
2. 路径验证宽松：动态工作区路径来自配置文件解析，缺乏严格的路径遍历防护，若配置文件被篡改可能导致文件写入非预期位置。
3. 恢复操作破坏性：虽有确认提示，但恢复过程会强制覆盖现有配置，无增量恢复或合并选项，误选备份版本可能导致数据丢失。
4. 生态依赖性强：专为 Clawdbot 设计，无法直接迁移至其他多代理平台，工具链深度绑定 pnpm、Clawdbot CLI 等特定技术栈。
5. 社区验证不足：作为相对较新的项目，长期稳定性与边缘场景处理（如磁盘满、网络中断时的 Git 操作）有待大规模生产环境检验。
适合的目标群体
- Clawdbot 平台运维人员：需要管理多代理生产环境的系统管理员
- DevOps 工程师：追求自动化、可回滚部署流程的技术团队
- 多代理应用开发者：频繁迭代代理配置、需要沙箱隔离测试的开发者
- 企业 IT 部门：对系统更新有严格变更管理流程、要求备份可审计的组织
使用风险
- 性能风险：首次完整备份可能耗时较长，尤其当工作区包含大量日志或模型文件时，建议在低峰期执行
- 依赖项风险：依赖 bash 4.0+、jq 1.6+、git、tar 及 pnpm，任一工具版本不兼容可能导致脚本异常退出
- 存储风险：备份目录默认位于用户主目录，若未监控磁盘空间，可能因备份累积导致系统磁盘耗尽
- 凭证暴露风险：备份包含明文凭证，若备份目录权限配置不当或被同步至非安全存储，可能引发安全事件