# Send Clawdbot Skill Update to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "clawdbot-skill-update", "name": "Clawdbot Skill Update", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/pasogott/clawdbot-skill-update", "canonicalUrl": "https://clawhub.ai/pasogott/clawdbot-skill-update", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/clawdbot-skill-update", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawdbot-skill-update", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "PUBLISH.md", "QUICK_REFERENCE.md", "README.md", "SKILL.md", "TEST.md", "UPDATE_CHECKLIST.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "clawdbot-skill-update", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T10:27:47.277Z", "expiresAt": "2026-05-06T10:27:47.277Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawdbot-skill-update", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawdbot-skill-update", "contentDisposition": "attachment; filename=\"clawdbot-skill-update-1.0.2.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "clawdbot-skill-update" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/clawdbot-skill-update" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/clawdbot-skill-update", "downloadUrl": "https://openagent3.xyz/downloads/clawdbot-skill-update", "agentUrl": "https://openagent3.xyz/skills/clawdbot-skill-update/agent", "manifestUrl": "https://openagent3.xyz/skills/clawdbot-skill-update/agent.json", "briefUrl": "https://openagent3.xyz/skills/clawdbot-skill-update/agent.md" } } ``` ## Documentation ### 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" ### 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: Create backup Stop gateway Pull latest code Adjust config for breaking changes Run doctor Test functionality 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 ### 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 ### 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 # Manual rollback cd ~/code/clawdbot git checkout pnpm install && pnpm build cp /clawdbot.json ~/.clawdbot/ pnpm clawdbot gateway restart ### 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 ### 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 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 ### Via ClawdHub clawdbot skills install clawdbot-update ### Manual git clone ~/.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 ## Trust - Source: tencent - Verification: Indexed source record - Publisher: pasogott - Version: 1.0.2 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T10:27:47.277Z - Expires at: 2026-05-06T10:27:47.277Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/clawdbot-skill-update) - [Send to Agent page](https://openagent3.xyz/skills/clawdbot-skill-update/agent) - [JSON manifest](https://openagent3.xyz/skills/clawdbot-skill-update/agent.json) - [Markdown brief](https://openagent3.xyz/skills/clawdbot-skill-update/agent.md) - [Download page](https://openagent3.xyz/downloads/clawdbot-skill-update)