clawdbot-skill-update – OpenClaw Skill

---

name: clawdbot-skill-update description: Comprehensive backup, update, and restore workflow with dynamic workspace detection homepage: https://github.com/pasogott/clawdbot-skill-update metadata: {"clawdbot":{"emoji":"💾","requires":{"bins":["bash","jq","tar","git"]},"tags":["backup","restore","update","multi-agent"]}}

Clawdbot Update Skill

Comprehensive backup, update, and restore workflow for Clawdbot installations.

Repository

• GitHub: https://github.com/clawdbot/clawdbot
• Upstream: origin/main
• Local Clone: ~/code/clawdbot (default)

Description

This skill provides a complete, modular update workflow for Clawdbot with dynamic workspace detection:

• Configuration files
• Agent states and sessions
• Credentials and auth tokens
• All agent workspaces (auto-detected from config)
• Cron jobs and sandboxes
• Git repository state

Key Features

✅ Dynamic Workspace Detection - Reads workspace paths from config
✅ Multi-Agent Support - Handles multiple agents automatically
✅ Safe Rollback - Full restore capability
✅ Git Integration - Tracks versions and remotes
✅ Validation - Pre/post checks included
✅ Dry Run - Preview before backup

Files

• config.json - Skill configuration (repo URLs, paths)
• backup-clawdbot-dryrun.sh - Dry run preview (no changes)
• backup-clawdbot-full.sh - Dynamic full backup script
• restore-clawdbot.sh - Dynamic restore script
• validate-setup.sh - Pre/post update validation
• check-upstream.sh - Check for available updates
• UPDATE_CHECKLIST.md - Step-by-step update checklist
• QUICK_REFERENCE.md - Quick command reference
• SKILL.md - This file
• README.md - Quick start guide

Dynamic Features

Both backup and restore scripts now:

• Read workspace paths from ~/.clawdbot/clawdbot.json
• Support any number of agents
• Handle missing workspaces gracefully
• Generate safe filenames from agent IDs

When to Use

Trigger this skill when asked to:

• "update clawdbot"
• "upgrade to latest version"
• "backup clawdbot before update"
• "restore clawdbot from backup"
• "rollback clawdbot update"

Usage

1. Preview Backup (Dry Run)

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

Shows:

• What files would be backed up
• Estimated backup size
• Workspace detection results
• Disk space availability
• Files that would be skipped

No files are created or modified!

2. Create Full Backup

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

Backs up:

• ~/.clawdbot/clawdbot.json (config)
• ~/.clawdbot/sessions/ (session state)
• ~/.clawdbot/agents/ (multi-agent state)
• ~/.clawdbot/credentials/ (auth tokens)
• ~/.clawdbot/cron/ (scheduled jobs)
• ~/.clawdbot/sandboxes/ (sandbox state)
• All agent workspaces (dynamically detected!)
• Git commit and status

Output: ~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS/

3. Update Clawdbot

Follow the checklist:

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

Key steps:

1. Create backup
2. Stop gateway
3. Pull latest code
4. Adjust config for breaking changes
5. Run doctor
6. Test functionality
7. Start gateway as daemon

4. Restore from Backup

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

Restores:

• All configuration
• All state files
• All workspaces
• Optionally: git version

Important Notes

Multi-Agent Setup

This skill is designed for multi-agent setups with:

• Multiple agents with separate workspaces
• Sandbox configurations
• Provider routing (WhatsApp/Telegram/Discord/Slack/etc.)

Breaking Changes in v2026.1.8

CRITICAL:

• DM Lockdown: DMs now default to pairing policy instead of open
• Groups: telegram.groups and whatsapp.groups are now allowlists
• Sandbox: Default scope changed to "agent" from implicit
• Timestamps: Now UTC format in agent envelopes

Backup Validation

After backup, always verify:

BACKUP_DIR=~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS
cat "$BACKUP_DIR/BACKUP_INFO.txt"
ls -lh "$BACKUP_DIR"

Should contain:

• ✅ clawdbot.json
• ✅ credentials.tar.gz
• ✅ workspace-*.tar.gz (one per agent)

Config Changes Required

Example: Switch WhatsApp to pairing:

jq '.whatsapp.dmPolicy = "pairing"' ~/.clawdbot/clawdbot.json | sponge ~/.clawdbot/clawdbot.json

Example: Set explicit sandbox scope:

jq '.agent.sandbox.scope = "agent"' ~/.clawdbot/clawdbot.json | sponge ~/.clawdbot/clawdbot.json

Workflow

Standard Update Flow

# 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

Rollback Flow

# 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

Testing After Update

Functionality Tests

• Provider DMs work (check pairing policy)
• Group mentions respond
• Typing indicators work
• Agent routing works
• Sandbox isolation works
• Tool restrictions enforced

New Features

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

Monitoring

# Live logs
pnpm clawdbot logs --follow

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

# Check status
pnpm clawdbot status
pnpm clawdbot gateway status

Troubleshooting

Common Issues

Gateway won't start:

pnpm clawdbot logs --grep error
pnpm clawdbot doctor

Auth errors:

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

Sandbox issues:

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

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

Emergency Restore

If something goes wrong:

# 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

Installation

Via ClawdHub

clawdbot skills install clawdbot-update

Manual

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

License

MIT - see LICENSE

Author

Pascal Schott (@pasogott)

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

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