Migrate

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.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install migrate

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.