migrate
v1.0.0Export 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.
Installation
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 bash scripts/export.sh -o ~/Desktop -
Transfer archive to new machine (scp, USB, cloud, etc.)
-
On new machine:
bash 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.