Clawdbot 更新技能

为 Clawdbot 安装提供全面的备份、更新和恢复工作流程。

代码仓库

• GitHub：https://github.com/clawdbot/clawdbot
• 上游仓库：origin/main
• 本地克隆：~/code/clawdbot（默认）

描述

此技能为 Clawdbot 提供了一个完整的、模块化的更新工作流程，并具备动态工作空间检测功能：

• 配置文件
• 代理状态和会话
• 凭据和认证令牌
• 所有代理工作空间（根据配置自动检测）
• 定时任务和沙箱
• 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更新"

使用方式

1. 预览备份（模拟运行）

~/.skills/clawdbot-update/backup-clawdbot-dryrun.sh

显示：

• 哪些文件将被备份
• 预估的备份大小
• 工作区检测结果
• 磁盘空间可用性
• 将被跳过的文件

不会创建或修改任何文件！

2. 创建完整备份

~/.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/

3. 更新Clawdbot

按照清单执行:

cat ~/.skills/clawdbot-update/UPDATE_CHECKLIST.md

关键步骤:

1. 创建备份
2. 停止网关
3. 拉取最新代码
4. 调整配置以应对重大变更
5. 运行医生
6. 测试功能
7. 以守护进程模式启动网关

4. 从备份恢复

~/.skills/clawdbot-update/restore-clawdbot.sh ~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS

恢复内容：

• 所有配置
• 所有状态文件
• 所有工作空间
• 可选项：git版本

重要说明

多代理设置

此技能专为以下多代理设置设计：

• 拥有独立工作空间的多个代理
• 沙箱配置
• 提供商路由（WhatsApp/Telegram/Discord/Slack/等）

v2026.1.8 版本中的破坏性变更

关键变更：

• 私信锁定：私信现在默认采用配对策略，而非开放策略
• 群组：telegram.groups并且WhatsApp群组现在为允许列表
• 沙盒：默认作用域已更改为"代理"从隐式
• 时间戳：代理信封中现在使用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. Check for updates
~/.skills/clawdbot-update/check-upstream.sh

# 2. Validate current setup
~/.skills/clawdbot-update/validate-setup.sh

# 3. Dry run
~/.skills/clawdbot-update/backup-clawdbot-dryrun.sh

# 4. Backup
~/.skills/clawdbot-update/backup-clawdbot-full.sh

# 5. Stop gateway
cd ~/code/clawdbot
pnpm clawdbot gateway stop

# 6. Update code
git checkout main
git pull --rebase origin main
pnpm install
pnpm build

# 7. Run doctor
pnpm clawdbot doctor --yes

# 8. Test
pnpm clawdbot gateway start  # foreground for testing

# 9. Deploy
pnpm clawdbot gateway stop
pnpm clawdbot gateway start --daemon

回滚流程

# Quick rollback
~/.skills/clawdbot-update/restore-clawdbot.sh <backup-dir>

# Manual rollback
cd ~/code/clawdbot
git checkout <old-commit>
pnpm install && pnpm build
cp <backup-dir>/clawdbot.json ~/.clawdbot/
pnpm clawdbot gateway restart

更新后测试

功能测试

• 供应商私信功能正常（检查配对策略）
• 群组提及响应正常
• 输入指示器工作正常
• 代理路由工作正常
• 沙箱隔离工作正常
• 工具限制强制执行

新功能

pnpm clawdbot agents list
pnpm clawdbot logs --tail 50
pnpm clawdbot providers list --usage
pnpm clawdbot skills list

监控

# Live logs
pnpm clawdbot logs --follow

# Or Web UI
open http://localhost:3001/logs

# Check status
pnpm clawdbot status
pnpm clawdbot gateway status

故障排除

常见问题

网关无法启动：

pnpm clawdbot logs --grep error
pnpm clawdbot doctor

认证错误：

# OAuth profiles might need re-login
pnpm clawdbot providers login <provider>

沙箱问题：

# Check sandbox config
jq '.agent.sandbox' ~/.clawdbot/clawdbot.json

# Check per-agent sandbox
jq '.routing.agents[] | {name, sandbox}' ~/.clawdbot/clawdbot.json

紧急恢复

如果出现问题：

# 1. Stop gateway
pnpm clawdbot gateway stop

# 2. Full restore
LATEST_BACKUP=$(ls -t ~/.clawdbot-backups/ | head -1)
~/.skills/clawdbot-update/restore-clawdbot.sh ~/.clawdbot-backups/$LATEST_BACKUP

# 3. Restart
pnpm clawdbot gateway start

安装

通过 ClawdHub

clawdbot skills install clawdbot-update

手动安装

git clone <repo-url> ~/.skills/clawdbot-update
chmod +x ~/.skills/clawdbot-update/*.sh

许可证

MIT - 参见LICENSE 文件

作者

Pascal Schott@pasogott为 Clawdbot 做出的贡献https://github.com/clawdbot/clawdbot

Contribution for Clawdbot
https://github.com/clawdbot/clawdbot