多代理系统的安全升级保险

Clawdbot 专属备份升级套件，动态检测多代理工作区，支持一键备份/回滚与配置迁移，确保更新零风险。

基本信息

• 技能名称?Clawdbot Skill Update
• 中文名称?多代理系统的安全升级保险
• 作者?pasogott
• 分类?专业技能
• 版本?1.0.2
• 标签?backup, restore, update, multi-agent, clawdbot, bash, git, devops

使用方法

使用说明
核心用法
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），纯自动化需额外封装 |