migrator

What This Skill Does

The OpenClaw Migrator is a specialized utility designed to facilitate the secure transfer of an entire OpenClaw agent environment—including configurations, learned memory, and custom skills—between different host machines. It functions by packaging the agent's sensitive data into a cryptographically secured .oca (OpenClaw Archive) file. Utilizing AES-256-GCM encryption, it ensures that your agent's sensitive tokens and personalized memory remain protected during transit. Beyond just the core data, the migrator performs path normalization and captures external system dependencies via a generated manifest, ensuring that your agent retains full functionality on the destination machine without manual configuration drift.

Installation

To integrate this utility into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/wenjie2024/openclaw-migrator

Ensure that you have appropriate write permissions for the directory where the .oca file will be generated.

Use Cases

• Upgrading Hardware: Seamlessly transfer your fully-trained agent from a legacy laptop to a new, high-performance workstation.
• Cloud Deployment: Package your local development environment to deploy to a remote cloud-hosted instance or virtual machine.
• Backup & Recovery: Create periodic, encrypted snapshots of your agent's intelligence and configuration to protect against data loss.
• Team Sharing: Share specific agent configurations with colleagues while ensuring credentials remain encrypted and secure.

Example Prompts

1. "Migrator, create an encrypted backup of my current agent configuration and save it as backup_01.oca on my desktop."
2. "I'm moving to a new server. Export my entire agent workspace and memory using the password 'QuantumAgent2024'."
3. "Import my agent settings from the file located at /volumes/backup/my-agent.oca and restore all dependencies."

Tips & Limitations

• Always remember your password: Because the Migrator uses strict AES-256-GCM encryption, there is no 'recover password' mechanism. If the password is lost, the archive becomes permanently unreadable.
• Verify dependencies: While the tool captures a Brewfile, ensure your target machine has internet access to re-download these dependencies during the import phase.
• Security best practices: Do not share the .oca file and the password through the same channel. Use a secure password manager to store the migration key.