Clawdbot Update Skill

Complete modular backup, update, and restore workflow for Clawdbot installations.

Repository: https://github.com/clawdbot/clawdbot

Quick Start

# 0. Dry run (see what would be backed up)
~/.skills/clawdbot-skill-update/backup-clawdbot-dryrun.sh

# 1. Create backup
~/.skills/clawdbot-skill-update/backup-clawdbot-full.sh

# 2. Follow checklist
cat ~/.skills/clawdbot-skill-update/UPDATE_CHECKLIST.md

# 3. Restore if needed
~/.skills/clawdbot-skill-update/restore-clawdbot.sh <backup-dir>

Files

What Gets Backed Up

• ✅ Configuration (~/.clawdbot/clawdbot.json)
• ✅ Sessions state
• ✅ Agent states (multi-agent)
• ✅ Credentials & auth tokens
• ✅ Cron jobs
• ✅ Sandbox states
• ✅ All agent workspaces (dynamically detected from config!)
• ✅ Git repository state (commit, branch, remotes)

Dynamic Workspace Detection

The scripts automatically discover all agent workspaces from your config:

# Reads from config:
.routing.agents.{agentId}.workspace

# Creates backups:
workspace-{agentId}.tar.gz

No hardcoded paths! Works with any agent configuration.

Critical Changes in v2026.1.8

⚠️ DM Lockdown: DMs default to pairing (was open)
⚠️ Groups: Now allowlists (add "*" for allow-all)
⚠️ Sandbox: Default scope is "agent" (was "session")
⚠️ Timestamps: UTC format in envelopes

Backup Location

~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS/
├── clawdbot.json
├── sessions.tar.gz
├── agents.tar.gz
├── credentials.tar.gz
├── cron.tar.gz
├── sandboxes.tar.gz
├── workspace-*.tar.gz       # Dynamically detected!
├── git-version.txt
├── git-status.txt
└── BACKUP_INFO.txt

Usage Examples

Before Major Update

# Full backup with validation
~/.skills/clawdbot-update/backup-clawdbot-full.sh

# Review what was backed up
ls -lh ~/.clawdbot-backups/pre-update-*/

After Update (if issues)

# Find latest backup
ls -t ~/.clawdbot-backups/ | head -1

# Restore
~/.skills/clawdbot-update/restore-clawdbot.sh ~/.clawdbot-backups/<dir>

Check Backup Status

LATEST=$(ls -t ~/.clawdbot-backups/ | head -1)
cat ~/.clawdbot-backups/$LATEST/BACKUP_INFO.txt

Testing After Update

# New CLI features
pnpm clawdbot agents list
pnpm clawdbot logs --tail 50
pnpm clawdbot providers list --usage

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

# Verify routing
# Send messages to your configured providers

Installation

Via ClawdHub (Recommended)

# Install from ClawdHub
clawdhub install clawdbot-skill-update

# Make scripts executable (required after ClawdHub install)
chmod +x ~/.skills/clawdbot-skill-update/*.sh

Via Git

# Clone to your skills directory
git clone https://github.com/pasogott/clawdbot-skill-update.git ~/.skills/clawdbot-skill-update

# Make scripts executable
chmod +x ~/.skills/clawdbot-skill-update/*.sh

Quick Test

# Test with dry run
~/.skills/clawdbot-skill-update/backup-clawdbot-dryrun.sh

Support

For issues, consult:

1. UPDATE_CHECKLIST.md for step-by-step guidance
2. SKILL.md for detailed troubleshooting
3. Clawdbot logs: pnpm clawdbot logs --follow
4. Run doctor: pnpm clawdbot doctor

License

MIT - see LICENSE

Author

Pascal Schott (@pasogott)

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