A secure utility for packaging and migrating OpenClaw Agent configurations, memory, and skills into portable, encrypted archives.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-migrator
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 openclaw-migrator 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 OpenClaw Migrator?
The OpenClaw Migrator is a specialized utility designed for developers who need to move their entire agent environment between machines without losing data. It captures the agent's state—including configurations, long-term memory, and installed skills—into a single, portable .oca archive. By utilizing Openclaw Skills to manage these migrations, users ensure their development workflows remain consistent and secure across different environments.
Built with security as a priority, the migrator handles sensitive files such as authentication tokens and core configuration settings by enforcing strong encryption. This skill is a vital component for anyone managing a production-grade Openclaw Skills setup who requires reliable backup and restore capabilities.
OpenClaw Migrator Use Cases
- Moving your agent development environment from an old laptop to a new machine.
- Creating secure, encrypted backups of your agent memory and skill configurations.
- Sharing a pre-configured agent state with team members or across different workstations.
- Ensuring system-level dependencies are documented and portable via dependency manifests.
How OpenClaw Migrator Works
- The export process captures all critical agent files, including openclaw.json and auth.token.
- A dependency manifest (Brewfile) is generated to record necessary system-level tools.
- The skill uses AES-256-GCM encryption with a mandatory password to package the data into a .oca file.
- Path normalization metadata is stored within a manifest.json file to ensure the workspace can be reconstructed on a different file system.
- On the destination machine, the import command decrypts the archive and restores the agent state to the local environment.
OpenClaw Migrator Setup
To begin using the migrator within your Openclaw Skills workflow, ensure the utility is installed and accessible. Use the following commands to manage your agent state:
# Export your agent state to an encrypted archive
migrator export --out my-agent.oca --password "your-secure-password"
# Import an agent state from an archive
migrator import --in my-agent.oca --password "your-secure-password"
OpenClaw Migrator Data Schema & Taxonomy
The OpenClaw Migrator organizes and protects your Openclaw Skills data using the following structure:
| Component | Description |
|---|---|
| .oca Archive | An encrypted AES-256-GCM package containing the agent state. |
| manifest.json | Metadata used for path normalization and environment restoration. |
| openclaw.json | The primary configuration file for the agent. |
| auth.token | Sensitive authentication credentials for connected services. |
| Brewfile | A list of system dependencies required for the agent to function. |
OpenClaw Migrator Advanced Features
- Mandatory AES-256-GCM encryption for all exports to ensure data confidentiality and integrity.
- Automated path normalization to resolve directory structure differences between source and destination machines.
- Dependency manifest capturing via Brewfile to maintain environmental parity.
- Secure handling of sensitive tokens and credentials with no option for unencrypted exports.
SKILL.md
Loading
Related Openclaw Skills
OpenClaw Migrator
A secure utility to package and migrate OpenClaw Agent states, memory, and skills into encrypted archives for seamless environment transitions.
UpNote AI Skill
A specialized tool for AI agents to programmatically create, organize, and navigate UpNote content via shell-based automation.
geomanic
A privacy-first GPS tracking skill for querying travel statistics, managing waypoints, and analyzing journey data via the Geomanic API.
Skill Updater
An automation utility designed to manage the versioning and publishing lifecycle of individual skills within a multi-skill repository.
Doubao Image and Video Skill
A comprehensive AI skill for generating high-quality images and videos and performing intelligent image edits via the ByteDance Doubao API.
CC Coder
An automated development assistant that utilizes the Claude Code CLI to execute, verify, and document complex programming tasks.
Featured*
