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

1. On old machine:

bash scripts/export.sh -o ~/Desktop

1. Transfer archive to new machine (scp, USB, cloud, etc.)

1. 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.