| name | migrate |
| description | Export and import Clawdbot installations for migration between machines. Use when the user wants to migrate Clawdbot to a new computer, backup their setup, or restore from a backup. Handles workspace files, config, WhatsApp sessions, and optionally credentials. |
Clawdbot Migration
Export and import complete Clawdbot installations.
Export
Create a portable archive of the current installation:
bash scripts/export.sh
Options:
--output, -o PATH — Output directory (default: current)--workspace PATH — Workspace path (default: ~/clawd)--include-sessions — Include session transcripts--include-credentials — Include credentials ⚠️ handle with care
Example:
bash scripts/export.sh -o /tmp --include-sessions
Creates: clawdbot-export-YYYYMMDD_HHMMSS.tar.gz
Import
Restore from an export archive on a new machine:
bash scripts/import.sh <archive.tar.gz>
Options:
--workspace PATH — Target workspace (default: ~/clawd)--force, -f — Overwrite without prompting
Example:
bash scripts/import.sh clawdbot-export-20260129_120000.tar.gz --force
What's Included
| Component | Default | Flag |
|---|
| Workspace (~/clawd) | ✓ | — |
| Config (clawdbot.json) | ✓ | — |
| Managed skills | ✓ | — |
| WhatsApp session | ✓ | — |
| Session transcripts | ✗ | --include-sessions |
| Credentials | ✗ | --include-credentials |
Excluded from workspace (can be rebuilt):
node_modules/, .next/, .open-next/, .vercel/, .wrangler/, .git/, dist/, build/
Migration Workflow
-
On old machine:
bash scripts/export.sh -o ~/Desktop
-
Transfer archive to new machine (scp, USB, cloud, etc.)
-
On new machine:
npm install -g clawdbot
bash scripts/import.sh ~/clawdbot-export-*.tar.gz
cd ~/clawd && clawdbot gateway start
WhatsApp session transfers automatically — no re-scan needed.
