Swap Your Agent to a New Computer

Built for non-technical users. Just follow these 3 steps.

Step 1: Create backup on old computer

Open Terminal on your old machine and run:

cd ~/Downloads/BOTBID\ BACK\ UP/migrate
./botbid-migrate.sh backup

Using Google Drive? Use this safer export instead:

cd ~/Downloads/BOTBID\ BACK\ UP/migrate
./botbid-migrate.sh backup-full

This also creates a checksum + transfer report for easy verification.

Step 2: Move backup file

AirDrop/USB/Google Drive these to the new computer Desktop:

1) openclaw-backup-*.tar.gz
2) openclaw-backup-*.sha256 (if you used backup-full)
3) BOTBID BACK UP folder (includes migrate scripts)

If you used backup-full, verify integrity on new Mac:

cd ~/Desktop
shasum -a 256 -c openclaw-backup-*.sha256

Step 3: One command on new computer

Open Terminal on the new machine and run:

cd ~/Downloads/BOTBID\ BACK\ UP/migrate
./botbid-migrate.sh move

This one command installs dependencies, restores your agent, patches paths, and validates everything.

If something is broken, run Doctor

This repair command fixes common transfer issues like gateway path mismatch, stale proxy settings, memory index issues, and Ollama auto-start.

cd ~/Downloads/BOTBID\ BACK\ UP/migrate
./botbid-migrate.sh doctor
Important: only run one machine per Telegram bot token. After testing on the new machine, stop the old machine gateway: 
openclaw gateway stop

Done. Your agent should respond exactly the same on the new computer.

Want interactive copy/paste mode? Use Transfer Wizard.

Need super simple picture steps? Use Super Easy Guide.

Need API-level docs too? See API Docs.