OpenClaw Migrator for Openclaw

A comprehensive backup and migration utility for moving your entire AI agent setup between machines with encryption and single-command restores.

dagangtj
v1.0.0
Feb 25, 2026
0
580
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install oc-migrator

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install oc-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?

OpenClaw Migrator is a robust utility designed to handle the full lifecycle of agent portability. It ensures that your AI's personality, long-term memory, custom skills, and configurations are never lost when changing hardware or recovering from a system failure. By bundling global configurations, workspace data, and cron jobs into a single archive, it simplifies the complex task of maintaining state across different environments.

This tool is essential for developers using Openclaw Skills who need a reliable way to maintain hot standbys or move workflows between macOS and Linux environments. Whether you are moving to a new Mac or deploying a server-side agent, this migrator preserves the continuity of your agent's learnings and operational history.

OpenClaw Migrator Use Cases

  • Migrating your AI agent setup to a new Mac or Linux server without losing historical data.
  • Creating encrypted backups of agent memory and skills for disaster recovery purposes.
  • Cloning a perfected agent environment to a second machine for redundant operations.
  • Transferring custom scripts, knowledge bases, and cron schedules between team members.

How OpenClaw Migrator Works

  1. The utility scans the local environment for global configurations, agent-specific settings, and workspace directories.
  2. It executes a dry-run or filtered export based on user-defined flags to identify relevant files while excluding ephemeral data like logs and node modules.
  3. The files are bundled into a compressed archive and, by default, encrypted using AES-256-CBC for secure transport.
  4. Upon restoration on a new machine, the script decrypts the archive and maps the files back to the appropriate local directories.
  5. Post-restore hooks allow for a gateway restart to immediately apply the migrated settings and resume operations.

OpenClaw Migrator Setup

To begin using this skill, ensure you have OpenClaw installed on your source and target machines.

# Navigate to your OpenClaw directory
cd ~/openclaw

# Create a secure, encrypted backup
bash scripts/migrate.sh export

# To restore on a new machine
bash scripts/migrate.sh restore path/to/your/backup.tar.gz.enc

OpenClaw Migrator Data Schema & Taxonomy

The migrator organizes data based on the OpenClaw directory structure to ensure cross-platform compatibility.

Component Category Preservation Strategy
Global & Agent Configs Configuration Full JSON preservation
Workspace & Memory Intelligence Recursive directory backup
Skills & Scripts Extensibility Preserves all custom Openclaw Skills
Cron Jobs Automation Exported via JSON and re-registered
API Keys Security Included in encrypted archive

OpenClaw Migrator Advanced Features

  • Multi-platform support enabling seamless migration from macOS to Linux and vice-versa.
  • Selective component export using the --only flag for targeted backups of memory or skills.
  • Environment variable integration (MIGRATE_PASSWORD) for automated, non-interactive backup pipelines.
  • Optional conversation history inclusion to balance backup size with data depth.
  • Native encryption for secure storage of API keys and sensitive agent learnings in cloud environments.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*