A robust utility for exporting and importing Clawdbot installations to facilitate seamless machine migrations, backups, and setup restoration.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install migrate
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install migrate using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is migrate?
The migrate skill is a specialized utility designed to handle the portability of Clawdbot environments. By using this tool within the ecosystem of Openclaw Skills, users can create comprehensive, portable archives of their workspaces, configuration settings, and even live WhatsApp sessions. It ensures that moving your AI agent setup to a new machine or restoring from a failure is a frictionless process, preserving the context and settings that make your agent unique.
By encapsulating complex dependencies and session data, the skill reduces the overhead of manual setup. It is particularly effective for developers who need to replicate environments quickly or maintain stateful agent interactions without repetitive authentication steps, ensuring your Openclaw Skills remain functional across different hardware.
migrate Use Cases
- Transferring a complete Clawdbot environment from an old computer to a new workstation.
- Creating periodic backups of agent workspaces and configurations for disaster recovery.
- Synchronizing complex agent environments across multiple development or production machines.
- Restoring a previously exported WhatsApp session to avoid re-scanning QR codes during setup.
How migrate Works
- Initiate the export process on the source machine to bundle the workspace, config files, and managed skills into a compressed tarball.
- Transfer the generated archive (e.g., clawdbot-export-YYYYMMDD.tar.gz) to the destination system using your preferred file transfer method.
- Run the import script on the target system to unpack the environment into the specified workspace directory.
- Re-initialize the environment and start the gateway to resume AI agent operations immediately.
migrate Setup
To create a portable archive of your current installation, run the following command on your source machine:
bash scripts/export.sh -o ~/Desktop --include-sessions
To restore or import that setup on a new machine, first ensure Clawdbot is installed, then run:
npm install -g clawdbot
bash scripts/import.sh path/to/clawdbot-export-archive.tar.gz
cd ~/clawd && clawdbot gateway start
migrate Data Schema & Taxonomy
The skill organizes data into a structured archive. The following table describes how the migration handles various components:
| Component | Included by Default | Optimization/Flag |
|---|---|---|
| Workspace (~/clawd) | Yes | Targeted via --workspace |
| Config (clawdbot.json) | Yes | Always included |
| Managed Skills | Yes | Always included |
| WhatsApp Sessions | Yes | Preserves login state |
| Session Transcripts | No | Enabled via --include-sessions |
| System Credentials | No | Enabled via --include-credentials |
Note: This skill automatically excludes transient build artifacts such as node_modules, .next, and .git folders to keep Openclaw Skills archives lightweight and portable.
migrate Advanced Features
- Credential Portability: Securely package API keys and sensitive credentials for private environment migrations.
- Workspace Customization: Specify custom source or target paths to accommodate non-standard installation directories.
- Session Preservation: Transfer live WhatsApp sessions to bypass QR code scanning on new devices.
- Intelligent Exclusion: Automatically filters out bulky, rebuildable folders like dist, build, and node_modules to optimize transfer speeds.
- Force Overwrite: Supports headless automation with a force flag to overwrite existing target configurations during import.
SKILL.md
Loading
Related Openclaw Skills
Gamma
Automate the creation of AI-powered presentations, documents, and web pages via the Gamma API.
fly-machines
A powerful developer tool for programmatically managing Fly.io Machines and containerized infrastructure using the Openclaw Skills framework.
Excel Online (Microsoft Graph)
A professional-grade skill for automating Microsoft Excel Online operations through the Microsoft Graph API.
Evernote Skill
A powerful integration for programmatically managing Evernote notes, notebooks, and tags through a standardized API interface.
Miro
A comprehensive tool for programmatically managing Miro boards, sticky notes, and shapes via the Miro V2 API.
New Relic
Monitor application performance and infrastructure health using New Relic's robust API and NRQL querying engine.
Featured*
