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

Excluded from workspace (can be rebuilt):

node_modules/, .next/, .open-next/, .vercel/, .wrangler/, .git/, dist/, build/

Migration Workflow

1. On old machine:

```bash

bash scripts/export.sh -o ~/Desktop

```

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

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