agent-migrate_skill

Overview

This skill handles cross-platform migration and deployment of OpenClaw agents, preserving identity, memory, and configuration. It packages agent state into portable exports, supports transfer and restore workflows, and provides options for merging or replacing target agents.

How this skill works

The skill exports the agent state (workspace, .openclaw config, skills, and session data) into an immutable archive with a manifest and a self-contained restore script. You transfer the archive to the target host (scp, git, or other transport) and run the included restore or use the import script to merge or replace the existing agent state. Optional scripts sync the state with a GitHub repo for versioned deployments.

When to use it

• Moving an OpenClaw agent from a local machine to a remote server while preserving identity and memory
• Cloning agent configuration and skills across development, staging, and production environments
• Backing up a complete agent state for disaster recovery and rollback
• Syncing workspace changes between development and production for controlled deployments
• Upgrading OpenClaw with the ability to rollback to a previous export

Best practices

• Sanitize openclaw.json before exporting to remove secrets and tokens
• Use --full export when you need session history and logs for forensic or debugging purposes
• Prefer Git-based sync for versioned deployments and auditability
• Verify target permissions and executable flags after import, especially when moving between OSes
• Rotate any credentials exposed during transfer and test agent functionality before cutover

Example use cases

• Export an agent on a developer laptop and import it to a cloud VM to run production workloads
• Create immutable backups of an agent before performing a risky configuration upgrade
• Clone a base agent configuration into multiple environment replicas for testing
• Sync workspace and skills to a GitHub repo to enable repeatable, versioned deployments
• Rollback to a known-good agent snapshot by re-importing a previous export with --replace