A robust migration and deployment toolkit designed to preserve OpenClaw agent identity, memory, and configuration across different environments.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install agent-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 agent-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 Agent Migrate?
The Agent Migrate skill provides a comprehensive framework for moving OpenClaw agents between local machines, remote servers, and cloud environments. By treating an agent's state—including its identity, long-term memory, and custom extensions—as a portable asset, this entry in the Openclaw Skills library ensures that your AI assistants retain their context and personality regardless of where they are hosted. It is specifically engineered to handle the complexities of agent state synchronization, making it an essential utility for developers managing multi-environment AI workflows.
This skill automates the packaging of core identity files like SOUL.md and MEMORY.md along with technical configurations, allowing for a seamless transition between platforms. Whether you are scaling your operations or ensuring disaster recovery, Agent Migrate maintains the integrity of your agent's lifecycle within the Openclaw Skills ecosystem.
Agent Migrate Use Cases
- Moving an agent from a local development machine to a high-performance remote server for production use.
- Cloning existing agent configurations to scale across multiple environments or team workspaces.
- Creating comprehensive backups of agent state for disaster recovery and long-term state preservation.
- Synchronizing workspace changes between development and production branches to maintain consistency.
- Upgrading core components of your Openclaw Skills setup with reliable rollback capabilities.
How Agent Migrate Works
- Export the source agent state using specialized scripts to generate a portable manifest containing the workspace and configuration tarballs.
- Create an immutable snapshot that includes identity, memory, and environment-specific notes.
- Transfer the exported package to the target destination via secure protocols like SSH or through version control systems like GitHub.
- Execute the restoration script on the target machine to import the agent state into the new Openclaw Skills environment.
- Choose between merging the new data with existing configurations or performing a clean replacement of the target state.
- Verify the agent identity and memory integrity on the new host to ensure a successful migration.
Agent Migrate Setup
To begin using migration tools within the Openclaw Skills framework, ensure the scripts are executable in your workspace:
# Grant execution permissions to the migration scripts
chmod +x scripts/export-agent.sh
chmod +x scripts/import-agent.sh
chmod +x scripts/sync-github.sh
# Perform a test export to verify the environment
./scripts/export-agent.sh my-agent-backup
Agent Migrate Data Schema & Taxonomy
The migration process organizes data into several logical layers to ensure consistency across the Openclaw Skills infrastructure:
| Component | Files Included | Purpose |
|---|---|---|
| Identity & Soul | IDENTITY.md, USER.md, SOUL.md | Preserves personality and user relationship |
| Memory & Context | MEMORY.md, memory/ directory | Migrates long-term context and daily logs |
| System Config | openclaw.json, agents/ | Captures gateway configuration and session data |
| Extensibility | skills/, extensions/ | Packages custom logic and third-party plugins |
Agent Migrate Advanced Features
- Full agent export including deep session history and verbose logs using the
--fullflag. - Native GitHub integration for versioned deployments and collaborative agent management via the Openclaw Skills CLI.
- Immutable snapshot generation for reliable disaster recovery and one-command rollbacks to previous states.
- Cross-platform compatibility handling path conversions and line endings for macOS, Linux, and Windows WSL.
- Atomic import options allowing for safe data merging or complete state replacement depending on deployment needs.
SKILL.md
Loading
Related Openclaw Skills
AskHuman
AskHuman provides Human Judgment as a Service, allowing AI agents to request real-world validation for tasks involving preference, tone, aesthetics, and trust.
ngamux
A lightweight and efficient HTTP router for Go designed for building high-performance web services with clean route organization.
Gowok
Gowok is a comprehensive Golang library designed to eliminate repetitive boilerplate when building project starters and frameworks.
Humanizer
A sophisticated writing editor for Openclaw Skills that identifies AI writing signatures and rewrites text to sound naturally human.
Agent Migrate
A specialized tool for migrating OpenClaw agents across servers and platforms while preserving identity, memory, and configuration.
WeChat MP Writer Assistant
A comprehensive writing assistant for WeChat Official Accounts that handles trend analysis, humanized content generation, and automated publishing.
Featured*
