How to move OpenClaw to a new computer without losing your agent
Move an OpenClaw agent to a new Mac, server or host: the full backup, the restore, what has to be set up again, and why the old Gateway must stay off.
On the old computer, stop the Gateway and run openclaw backup create --output ~/Backups/openclaw --verify. Copy the archive across, install the same OpenClaw version (or a newer one) on the new computer, unpack it with openclaw backup restore, move it into place, run openclaw doctor and start the Gateway. Move the whole backup, not just MEMORY.md or the config file, and keep the old Gateway stopped for good: two copies of one agent fight over the same chat connections.
What has to come with it
The agent you talk to is spread across more than its memory file. OpenClaw’s migration guide lists what a move has to carry: the configuration, the model sign-ins and API keys, the conversation history, the chat connections (the WhatsApp login, the Telegram session), and the workspace with MEMORY.md, USER.md, SOUL.md, skills and prompts. Current versions keep much of that in SQLite databases rather than plain files, so copying openclaw.json and a few Markdown files across gives you an agent with the right name and none of its sign-ins, history or connections. The backup command collects all of it into one archive.
Some things the agent depends on live outside OpenClaw entirely: programs it installed for itself, scheduled jobs set up in the computer’s own scheduler rather than in OpenClaw, SSH keys, a Tailscale login, a browser profile with your sign-ins. Ask the agent before the move what it has installed or set up outside its workspace, and keep the list.
The move, step by step
On the old computer, check where the state lives and which version you run, then stop the agent and back it up:
openclaw status
openclaw --version
openclaw gateway stop
mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verifyCopiedStopping first matters for a move: the backup can copy a running agent safely, but anything the agent does after the copy would be left behind. Move the .tar.gz by scp, a USB drive or another private route; it contains every key the agent holds, so it does not go through email or a public file-sharing link.
On the new computer, install OpenClaw at the same version as the old one, or newer. A newer version moves the data to its own format on first start; an older one refuses data from a newer one. Onboarding may create a fresh ~/.openclaw; that is fine, the restore replaces it. Then unpack the archive into an empty folder:
openclaw backup restore ~/openclaw-backup.tar.gz --target ~/openclaw-restoredCopiedThe restore checks the archive and writes nothing into the live agent. With the Gateway stopped, move the restored state into place (or point OPENCLAW_STATE_DIR at it), using the manifest.json inside to see where the configuration, credentials and workspace go. From a Mac to Linux the home folder changes, from /Users/you to /home/you, so map each part to its new path rather than copying the old ones. Make sure the user who will run the Gateway owns the files, then:
openclaw doctor
openclaw gateway start
openclaw statusCopiedCheck what the migration guide checks: the Gateway is running, the channels are connected without pairing again, the dashboard shows your past conversations, and the agent knows who you are. Ask it something only it would remember.
Only one of them may run
The old and new Gateway are the same agent with the same credentials. Left running together, they compete: Telegram hands each message to only one of them and rejects the other’s connection, a WhatsApp login can be signed out, and scheduled jobs run twice. Keep the old Gateway stopped, and switch off whatever would start it again: a login item or LaunchAgent on a Mac, a system service on Linux. Once the new one has run for a few days, uninstall OpenClaw from the old computer and delete its old backups along with it.
What usually needs doing again
- Plugins. The archive keeps their settings, not their installed code. Reinstall or update each one (
openclaw plugins update <id>). - WhatsApp. Its login carries state that changes with use, and an older copy can fall out of step. If the agent stops receiving WhatsApp messages, link it again from the dashboard.
- Telegram or Discord tokens kept in an environment file. If the old setup read
TELEGRAM_BOT_TOKENorDISCORD_BOT_TOKENfrom an.envfile, check that the restored state directory’s.envhas them;openclaw doctorwarns when one is missing. - A profile or custom state folder. If the old Gateway ran with
--profileorOPENCLAW_STATE_DIR, the new one must too, or the channels look logged out and the history looks empty. - Anything only a Mac can do. iMessage needs a Mac signed into Messages, so an agent leaving a Mac mini for a Linux server leaves iMessage behind, or keeps that Mac as a node for it.
When your old host has closed
Three managed OpenClaw hosts have closed in 2026, and what their owners can still save differs:
- KiloClaw’s end date was 20 October 2026, by Kilo’s email to subscribers, which said its workspaces would be deleted. After KiloClaw covers where its agents’ files may still be and how to rebuild from them.
- Klaus shut on 1 September 2026, and its in-app export closed with it. Klaus’s closing page says an export taken before then includes a recovery prompt: paste it into your new OpenClaw and it restores the workspace, skills and chat history, then walks you through reconnecting Slack, Telegram and WhatsApp. Without an export, the page asks you to email support@klausai.com.
- American Claw is winding down with all memberships cancelled, and its notice gives no export route. Its terms deleted an instance’s data at the end of the billing period, so plan on a fresh agent, rebuilt from whatever you kept.
Starting fresh is less of a loss than it sounds if you saved the Markdown files: an agent’s personality and memory live in SOUL.md, USER.md and MEMORY.md, which any new OpenClaw reads from its workspace. Keeping your agent’s personality and memory in files covers what each one holds.
From a Mac mini to the cloud
The usual reason to move is the computer rather than the agent: a Mac mini at home sleeps, loses power, and needs its updates and backups run by you. A VPS keeps the agent running when your home internet drops, with the same backup and restore as above, and you take on the server. If you would rather not run any computer for it, managed OpenClaw hosts take the machine off your hands, and each takes in an existing agent its own way: an uploaded backup, files you copy in over SSH, or nothing documented at all.
Moving onto Everpod’s OpenClaw pod
On Everpod’s OpenClaw pod there is no restore to run: your agent moves itself in from one .zip file you attach in its chat. On the old computer, send your agent:
I'm moving you to a new computer. Put everything that makes you you into a single .zip file: your workspace files (who you are, what you know about me, your memory and notes) and every skill you've made, plus a short note listing your scheduled jobs (what each does, when, and where it sends). Leave out passwords and API keys. Tell me where the file is.CopiedOnce you have the file, stop the old Gateway (openclaw gateway stop) and keep it stopped. On your pod’s page, tap Open the OpenClaw control panel. In the chat, tap + beside the message box, choose File and pick the .zip, then send:
I've moved you here from my old computer. The attached file is what you packed before the move: your workspace, your skills and a list of your scheduled jobs. Move back in: put your identity, personality, what you know about me and your memory where they belong on this computer, install your skills, and set your scheduled jobs up again. Keep this computer's own setup and files as they are. When you're done, tell me what came across and anything you couldn't bring.CopiedA few minutes later your agent answers with its own name and personality, knows what it knew about you, and has its memory, the skills it made and its scheduled jobs back, and it lists what it brought. Past conversations stay on the old computer, and so do passwords and API keys: if it ran on your own provider key, add it again with Add your own API key in the pod’s Settings.
Then connect your chat app again. For Telegram, send BotFather /revoke for your bot, tap Telegram on your pod’s page and paste the new code; the same bot keeps working, with the new agent answering. When it answers you there, send “From now on, send your scheduled messages to me here.”