Clawdbot Skill Update — Clawd机器人 技能 更新

Clawdbot 更新技能 综合备份、更新和恢复工作流程，适用于 Clawdbot 安装。 仓库 GitHub：https://github.com/clawdbot/clawdbot 上游：origin/main 本地克隆：~/code/clawdbot（默认）

描述 本技能为 Clawdbot 提供了一个完整的、模块化的更新工作流程，具有动态工作空间检测： 配置文件 代理状态和会话 凭证和身份验证令牌 所有代理工作空间（从配置文件自动检测） Cron 作业和沙盒 Git 仓库状态

主要特性 ✅ 动态工作空间检测 - 从配置文件读取工作空间路径 ✅ 多代理支持 - 自动处理多个代理 ✅ 安全回滚 - 具有完全恢复能力 ✅ Git 集成 - 跟踪版本和远程仓库 ✅ 验证 - 包括预更新和后更新检查 ✅ 干跑 - 预览备份

文件 config.json - 技能配置（仓库 URL、路径） backup-clawdbot-dryrun.sh - 干跑预览（无更改） backup-clawdbot-full.sh - 动态全备份脚本 restore-clawdbot.sh - 动态恢复脚本 validate-setup.sh - 更新前验证检查 check-upstream.sh - 检查可用更新 UPDATE_CHECKLIST.md - 更新步骤检查清单 QUICK_REFERENCE.md - 快速命令参考 SKILL.md - 本文件 README.md - 快速入门指南

动态特性 备份和恢复脚本现在： 从 ~/.clawdbot/clawdbot.json 读取工作空间路径 支持任意数量的代理 优雅地处理缺失的工作空间 从代理 ID 生成安全的文件名

何时使用 触发此技能时： “更新 Clawdbot” “升级到最新版本” “在更新前备份 Clawdbot” “从备份恢复 Clawdbot” “回滚 Clawdbot 更新”

使用方法

• 预览备份（干跑）

~/.skills/clawdbot-update/backup-clawdbot-dryrun.sh 显示： 将要备份的文件 预计备份大小 工作空间检测结果 磁盘空间可用性 将要跳过的文件 无文件创建或修改！

• 创建全备份

~/.skills/clawdbot-update/backup-clawdbot-full.sh 备份： ~/.clawdbot/clawdbot.json（配置） ~/.clawdbot/sessions/（会话状态） ~/.clawdbot/agents/（多代理状态） ~/.clawdbot/credentials/（身份验证令牌） ~/.clawdbot/cron/（计划任务） ~/.clawdbot/sandboxes/（沙盒状态） 所有代理工作空间（动态检测！） Git 提交和状态 输出：~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS/

• 更新 Clawdbot

按照检查清单： cat ~/.skills/clawdbot-update/UPDATE_CHECKLIST.md 主要步骤： 创建备份 停止网关 拉取最新代码 调整配置以适应破坏性更改 运行医生 测试功能 以守护进程方式启动网关

• 从备份恢复

~/.skills/clawdbot-update/restore-clawdbot.sh ~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS 恢复： 所有配置 所有状态文件 所有工作空间 可选：Git 版本

重要注意事项 多代理设置 本技能适用于具有以下特点的多代理设置： 多个代理具有单独的工作空间 沙盒配置 提供者路由（WhatsApp/Telegram/Discord/Slack 等）

v2026.1.8 中的破坏性更改 CRITICAL：DM 锁定：DM 现在默认为配对策略，而不是开放 群组：telegram.groups 和 whatsapp.groups 现在是允许列表 沙盒：默认范围从隐式更改为“代理” 时间戳：现在在代理信封中使用 UTC 格式

备份验证 备份后，始终验证： BACKUP_DIR=~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS cat "$BACKUP_DIR/BACKUP_INFO.txt" ls -lh "$BACKUP_DIR" 应包含： ✅ clawdbot.json ✅ credentials.tar.gz ✅ workspace-*.tar.gz（每个代理一个）

配置更改 示例：切换 WhatsApp 到配对： jq '.whatsapp.dmPolicy = "pairing"' ~/.clawdbot/clawdbot.json | sponge ~/.clawdbot/clawdbot.json 示例：设置显式沙盒范围： jq '.agent.sandbox.scope = "agent"' ~/.clawdbot/clawdbot.json | sponge ~/.clawdbot/clawdbot.json

工作流 标准更新流程 # 1. 检查更新 ~/.skills/clawdbot-update/check-upstream.sh # 2. 验证当前设置 ~/.skills/clawdbot-update/validate-setup.sh # 3. 干跑 ~/.skills/clawdbot-update/backup-clawdbot-dryrun.sh # 4. 备份 ~/.skills/clawdbot-update/backup-clawdbot-full.sh # 5. 停止网关 cd ~/code/clawdbot pnpm clawdbot gateway stop # 6. 更新代码 git checkout main git pull --rebase origin main pnpm install pnpm build # 7. 运行医生 pnpm clawdbot doctor --yes # 8. 测试 pnpm clawdbot gateway start # 前台测试 # 9. 部署 pnpm clawdbot gateway stop pnpm clawdbot gateway start --daemon

回滚流程 # 快速回滚 ~/.skills/clawdbot-update/restore-clawdbot.sh # 手动回滚 cd ~/code/clawdbot git checkout pnpm install && pnpm build cp /clawdbot.json ~/.clawdbot/ pnpm clawdbot gateway restart

更新后测试 功能测试 提供者 DM 工作（检查配对策略） 群组提及响应 输入指示器工作 代理路由工作 沙盒隔离工作 工具限制强制执行 新功能 pnpm clawdbot agents list pnpm clawdbot logs --