← Back to Skills Marketplace
pasogott

Clawdbot Skill Update

by pasogott · GitHub ↗ · v1.0.2
cross-platform ✓ Security Clean
3485
Downloads
6
Stars
27
Active Installs
3
Versions
Install in OpenClaw
/install clawdbot-skill-update
Description
Comprehensive backup, update, and restore workflow with dynamic workspace detection
README (SKILL.md)

Clawdbot Update Skill

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

Repository

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 \x3Cbackup-dir>

# Manual rollback
cd ~/code/clawdbot
git checkout \x3Cold-commit>
pnpm install && pnpm build
cp \x3Cbackup-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 \x3Cprovider>

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 \x3Crepo-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

Usage Guidance
This skill appears to be what it claims: a local backup/update/restore tool for Clawdbot. Before running it: 1) Review the scripts yourself (they will read and archive ~/.clawdbot and any workspaces listed in your config, including credentials and auth tokens). 2) Run the dry-run script first (~/.skills/clawdbot-update/backup-clawdbot-dryrun.sh) to verify which paths will be archived. 3) Ensure you have pnpm (and sponge if you plan to use the SKILL.md examples) available — SKILL.md calls pnpm for stopping/starting/building and examples use sponge, but those binaries are not listed in the metadata. 4) Protect the backup directory (~/.clawdbot-backups) — backups will contain secrets. 5) Test restore in a safe environment if possible; restores will overwrite files and workspaces. If you do not fully trust the source, don’t run the full backup/restore on a production system until you’ve inspected the scripts locally.
Capability Analysis
Type: OpenClaw Skill Name: clawdbot-skill-update Version: 1.0.2 The OpenClaw AgentSkills skill bundle 'clawdbot-skill-update' is classified as benign. The skill's purpose is to provide a comprehensive backup, update, and restore workflow for Clawdbot installations, which inherently requires extensive file system access and modification. All scripts (`backup-clawdbot-dryrun.sh`, `backup-clawdbot-full.sh`, `restore-clawdbot.sh`, `validate-setup.sh`, `check-upstream.sh`) perform actions directly aligned with this stated purpose, such as archiving configuration, session states, agent data, credentials, and dynamically detected workspaces, as well as interacting with a local Git repository and the `pnpm clawdbot` CLI. Network activity is limited to `git fetch origin` for checking updates from GitHub, which is legitimate. There is no evidence of data exfiltration to unauthorized external endpoints, persistence mechanisms, obfuscation, or prompt injection attempts in the markdown files (SKILL.md, README.md, etc.) that would instruct an AI agent to perform malicious actions. The documentation is transparent, includes warnings for destructive operations, and even contains explicit security checks in `TEST.md`.
Capability Assessment
ℹ Purpose & Capability
The skill's name and description match what the scripts do: dynamic detection of agent workspaces, full backup, restore, and update checks against ~/code/clawdbot. One minor inconsistency: the SKILL.md metadata declares required binaries (bash, jq, tar, git) but the instructions and workflow also expect 'pnpm' (used to stop/start/build the gateway) and examples reference 'sponge' — those are not listed. This is likely an omission but should be noted before install.
✓ Instruction Scope
The SKILL.md and included scripts explicitly read/wrap files under ~/.clawdbot (config, sessions, agents, credentials, cron, sandboxes) and arbitrary workspaces whose paths are read from ~/.clawdbot/clawdbot.json. They also interact with ~/code/clawdbot (git/pnpm). All of these actions are within the stated scope of backing up and restoring Clawdbot state. Note: restore extracts into the configured workspace paths and will overwrite those locations (the script prompts for confirmation).
✓ Install Mechanism
There is no install spec and this is an instruction-only skill containing plain shell scripts — no remote downloads, package installs, or archive extractions pulled from external URLs. That minimizes install-time risk.
ℹ Credentials
The skill requests no environment variables or external credentials, and it does not call out any remote endpoints for exfiltration. However, by design it reads and archives sensitive local data (credentials, auth tokens, agent workspaces). That is proportional to its backup/restore purpose but is sensitive — users should expect backups to contain secrets and protect the backup directory accordingly.
✓ Persistence & Privilege
The skill is not marked always:true and does not try to modify other skills or system-wide agent settings. It operates on user-owned files and directories and calls locally-available tools (git/pnpm). The scripts will write backups to ~/.clawdbot-backups and can overwrite workspace paths during restore — that is expected for a restore tool.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install clawdbot-skill-update
  3. After installation, invoke the skill by name or use /clawdbot-skill-update
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Added frontmatter metadata block to SKILL.md, including name, description, homepage, and tool requirements. - No changes to functionality or workflow; documentation content and usage instructions remain unchanged. - New metadata improves discoverability and integration in compatible platforms.
v1.0.1
- Updated README.md with improved or corrected instructions and quick start information. - No changes to code, scripts, or SKILL.md; functionality remains unchanged.
v1.0.0
Clawdbot Update Skill 1.0.0 – Initial release - Provides a modular, comprehensive backup, update, and restore workflow for Clawdbot installations. - Features dynamic workspace detection and full multi-agent support. - Includes safe rollback and restore functionality backed by Git integration and validation scripts. - Supports dry run previews before backup and detailed checklists for update and restore processes. - Handles breaking configuration changes for clawdbot v2026.1.8, including new DM, group, sandbox, and timestamp policies.
Metadata
Slug clawdbot-skill-update
Version 1.0.2
License —
All-time Installs 27
Active Installs 27
Total Versions 3
Frequently Asked Questions

What is Clawdbot Skill Update?

Comprehensive backup, update, and restore workflow with dynamic workspace detection. It is an AI Agent Skill for Claude Code / OpenClaw, with 3485 downloads so far.

How do I install Clawdbot Skill Update?

Run "/install clawdbot-skill-update" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Clawdbot Skill Update free?

Yes, Clawdbot Skill Update is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Clawdbot Skill Update support?

Clawdbot Skill Update is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Clawdbot Skill Update?

It is built and maintained by pasogott (@pasogott); the current version is v1.0.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463368 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259467 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200457 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191163 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190189 · by oswalpalash

💬 Comments