Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Comprehensive backup, update, and restore workflow with dynamic workspace detection
Comprehensive backup, update, and restore workflow with dynamic workspace detection
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Comprehensive backup, update, and restore workflow for Clawdbot installations.
GitHub: https://github.com/clawdbot/clawdbot Upstream: origin/main Local Clone: ~/code/clawdbot (default)
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
โ 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
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
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
Trigger this skill when asked to: "update clawdbot" "upgrade to latest version" "backup clawdbot before update" "restore clawdbot from backup" "rollback clawdbot update"
~/.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!
~/.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/
Follow the checklist: cat ~/.skills/clawdbot-update/UPDATE_CHECKLIST.md Key steps: Create backup Stop gateway Pull latest code Adjust config for breaking changes Run doctor Test functionality Start gateway as daemon
~/.skills/clawdbot-update/restore-clawdbot.sh ~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS Restores: All configuration All state files All workspaces Optionally: git version
This skill is designed for multi-agent setups with: Multiple agents with separate workspaces Sandbox configurations Provider routing (WhatsApp/Telegram/Discord/Slack/etc.)
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
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)
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
# 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
Provider DMs work (check pairing policy) Group mentions respond Typing indicators work Agent routing works Sandbox isolation works Tool restrictions enforced
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
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
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
clawdbot skills install clawdbot-update
git clone <repo-url> ~/.skills/clawdbot-update chmod +x ~/.skills/clawdbot-update/*.sh
MIT - see LICENSE
Pascal Schott (@pasogott) Contribution for Clawdbot https://github.com/clawdbot/clawdbot
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Largest current source with strong distribution and engagement signals.