clawdbot-skill-updateComprehensive backup, update, and restore workflow with dynamic workspace detection
Install via ClawdBot CLI:
clawdbot install pasogott/clawdbot-skill-updateRequires:
Comprehensive backup, update, and restore workflow for Clawdbot installations.
origin/main~/code/clawdbot (default)This skill provides a complete, modular update workflow for Clawdbot with dynamic workspace detection:
β 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 scriptrestore-clawdbot.sh - Dynamic restore scriptvalidate-setup.sh - Pre/post update validationcheck-upstream.sh - Check for available updatesUPDATE_CHECKLIST.md - Step-by-step update checklistQUICK_REFERENCE.md - Quick command referenceSKILL.md - This fileREADME.md - Quick start guideBoth backup and restore scripts now:
~/.clawdbot/clawdbot.jsonTrigger this skill when asked to:
~/.skills/clawdbot-update/backup-clawdbot-dryrun.sh
Shows:
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)Output: ~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS/
Follow the checklist:
cat ~/.skills/clawdbot-update/UPDATE_CHECKLIST.md
Key steps:
~/.skills/clawdbot-update/restore-clawdbot.sh ~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS
Restores:
This skill is designed for multi-agent setups with:
CRITICAL:
pairing policy instead of opentelegram.groups and whatsapp.groups are now allowlists"agent" from implicitAfter backup, always verify:
BACKUP_DIR=~/.clawdbot-backups/pre-update-YYYYMMDD-HHMMSS
cat "$BACKUP_DIR/BACKUP_INFO.txt"
ls -lh "$BACKUP_DIR"
Should contain:
clawdbot.jsoncredentials.tar.gzworkspace-*.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
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
Generated Mar 1, 2026
A business deploys multiple AI agents for handling customer inquiries across WhatsApp, Telegram, and Slack, each with dedicated workspaces. This skill automates backup before updates to prevent data loss from agent states and sessions, ensuring seamless rollback if issues arise with new versions like DM policy changes.
A tech company uses Clawdbot for internal AI tooling with sandboxed environments and cron jobs. The skill's dynamic workspace detection and validation scripts help maintain uptime during updates, critical for teams relying on continuous integration and deployment workflows.
An online learning platform employs Clawdbot agents to interact with students via multiple messaging platforms. The skill's backup and restore capabilities protect configuration and credentials, allowing safe updates to adapt to breaking changes like new timestamp formats without disrupting educational sessions.
A healthcare provider uses Clawdbot to manage patient communication across agents for scheduling and reminders. The skill's multi-agent support and dry-run feature ensure updates are tested beforehand, minimizing risks to sensitive data and compliance with operational policies.
Offer subscription-based management of Clawdbot installations for clients, using this skill to handle updates, backups, and restores as part of a service package. Revenue comes from monthly fees for maintenance, monitoring, and ensuring uptime across multi-agent setups.
Provide consulting services to businesses integrating Clawdbot, leveraging this skill to streamline update workflows and mitigate risks from breaking changes. Revenue is generated through project-based fees for setup, customization, and ongoing support.
Develop training courses and certifications for Clawdbot administrators, using this skill as a practical tool for teaching backup, update, and restore best practices. Revenue comes from course sales, certification exams, and workshop enrollments.
π¬ Integration Tip
Ensure all required binaries (bash, jq, tar, git) are installed and test the dry-run script first to preview workspace detection before executing full backups in production environments.
Transform AI agents from task-followers into proactive partners that anticipate needs and continuously improve. Now with WAL Protocol, Working Buffer, Autonomous Crons, and battle-tested patterns. Part of the Hal Stack π¦
Use the ClawdHub CLI to search, install, update, and publish agent skills from clawdhub.com. Use when you need to fetch new skills on the fly, sync installed skills to latest or a specific version, or publish new/updated skill folders with the npm-installed clawdhub CLI.
Clawdbot documentation expert with decision tree navigation, search scripts, doc fetching, version tracking, and config snippets for all Clawdbot features
Interact with Moltbook social network for AI agents. Post, reply, browse, and analyze engagement. Use when the user wants to engage with Moltbook, check their feed, reply to posts, or track their activity on the agent social network.
OpenClaw CLI wrapper β gateway, channels, models, agents, nodes, browser, memory, security, automation.
MoltGuard β runtime security plugin for OpenClaw agents by OpenGuardrails. Helps users install, register, activate, and check the status of MoltGuard. Use wh...