Skip to content

clawdbot-skill-update

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

clawdbot-skill-update

README.md

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

File Purpose
SKILL.md Complete skill documentation
backup-clawdbot-dryrun.sh Dry run - preview backup without changes
backup-clawdbot-full.sh Full backup script
restore-clawdbot.sh Restore from backup
validate-setup.sh Validate configuration
check-upstream.sh Check for updates
UPDATE_CHECKLIST.md Step-by-step update guide
QUICK_REFERENCE.md Quick command reference
METADATA.md Skill metadata and architecture

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