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.