A dedicated CLI utility for migrating OpenClaw configurations, skills, and environment data to a new host via SSH.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-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 openclaw-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 OpenClaw Migration Skill?
The OpenClaw Migration Skill provides an automated, secure workflow for transferring an entire OpenClaw instance from one host to another. By leveraging SSH, it ensures that your agent's memory, installed skills, and complex configurations remain persistent during hardware upgrades or server transitions.
This utility is a vital component for users who rely on Openclaw Skills and need a reliable way to scale or relocate their AI agent infrastructure without manual reconfiguration. It handles everything from directory synchronization to environment variable persistence, ensuring your agent environment is ready for production on a new machine in minutes.
OpenClaw Migration Skill Use Cases
- Upgrading your AI agent host to more powerful hardware
- Moving a local OpenClaw development environment to a production VPS
- Cloning agent configurations for redundancy across different servers
- Streamlining the setup of new nodes within a homelab environment
How OpenClaw Migration Skill Works
- Run the setup command to define target host credentials and SSH parameters.
- Perform a connection test to verify network and authentication paths between hosts.
- Initiate the migration to sync the primary workspace, including skills and memory.
- Synchronize environment variables and API tokens for connected services like Home Assistant and GitHub.
- Replicate system cron jobs to the new host to maintain automation schedules.
- Automatically boot the OpenClaw gateway on the destination host to complete the move.
OpenClaw Migration Skill Setup
Before starting, ensure you have SSH access to the target host and NPM installed. Install the skill and then configure your migration target using the following commands:
# Initialize the migration target configuration
openclaw-migrate setup
# Verify the connection to the new host
openclaw-migrate test
# Execute the full migration
openclaw-migrate migrate
Follow the interactive prompts to provide the host IP, SSH username, and path to your SSH key.
OpenClaw Migration Skill Data Schema & Taxonomy
The migration skill maps the following data structures and directories across systems to ensure consistency:
| Data Type | Path / Source | Description |
|---|---|---|
| Workspace | ~/.openclaw/ |
Contains skills, local memory, and core workspace config |
| Global Config | ~/.config/openclaw/ |
System-level settings and host preferences |
| Environment | API Tokens | Keys for Home Assistant, GitHub, Brave, and Google |
| Automation | Crontab | Scheduled tasks and periodic agent triggers |
OpenClaw Migration Skill Advanced Features
- Automatic remote installation of the OpenClaw npm package if missing on the target host
- Secure synchronization of sensitive API keys and custom environment variables
- Seamless migration of system-level cron jobs for task persistence
- Real-time status checking and configuration verification for easy debugging
- Comprehensive error handling for SSH connectivity and specific file synchronization failures
- Integration with the wider Openclaw Skills library for total environment portability
SKILL.md
Loading
Related Openclaw Skills
SkillStore
SkillStore is an intelligent package manager designed to search, install, and create Openclaw Skills through a unified CLI interface.
KKClaw Server
A high-performance, headless OpenClaw client optimized for remote Ubuntu and Raspbian server environments.
Home Assistant Skill
A command-line interface for managing and controlling smart home devices through the Home Assistant API.
Dashboard Skill
A unified web-based terminal interface for real-time task management, system monitoring, and network tracking.
SkillStore
A comprehensive CLI manager for discovering, installing, and bootstrapping Openclaw Skills with an intelligent relevance-based search engine.
Gandi Domain Registrar Skill
A comprehensive integration for managing Gandi.net domains, DNS records, and email forwarding using automated Node.js scripts.
Featured*
