A specialized migration and backup utility that packages an entire OpenClaw agent workspace into a single portable .soul archive.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-teleport
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-teleport 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-teleport?
openclaw-teleport is a robust command-line utility designed to handle the entire lifecycle of agent mobility. By wrapping the @kagura-agent/openclaw-teleport npm package, it allows developers to move their AI agents between different environments without losing identity, memory, or complex configurations. This tool is a cornerstone for users managing various Openclaw Skills who require a reliable way to ensure business continuity and environment parity.
The skill operates by creating a .soul file, which is a compressed archive containing the agent's full workspace, database, and sensitive credentials. Whether you are upgrading your local hardware or deploying an agent to a remote server, this utility automates the tedious manual steps of reconfiguration and file transfer.
openclaw-teleport Use Cases
- Migrating an active AI agent from a local development machine to a production server.
- Creating scheduled backups to safeguard agent memory and long-term learning data.
- Performing disaster recovery to restore an agent's state after system failure.
- Cloning a baseline agent configuration to use as a template for new specialized agents.
How openclaw-teleport Works
- The user initiates the pack command to scan the agent workspace and openclaw.json configuration.
- The utility compiles identity files, memory, skills, and channel credentials into a single .soul tar.gz archive.
- The archive can then be moved to a new destination machine via secure transfer protocols.
- Upon running the unpack command, the tool automatically detects missing dependencies and restores the workspace structure.
- The process concludes by re-cloning necessary GitHub repositories and restarting the agent gateway for immediate use.
openclaw-teleport Setup
To get started with this migration tool, install it globally via npm:
npm install -g @kagura-agent/openclaw-teleport
You can also execute commands directly without a permanent installation by using npx:
npx @kagura-agent/openclaw-teleport pack
openclaw-teleport Data Schema & Taxonomy
The skill organizes agent data into a structured manifest within the .soul archive to ensure high fidelity during restoration:
| Component | Description |
|---|---|
| Workspace Files | Includes identity files, skill logic, workflows, and local databases. |
| Credentials | API tokens and channel secrets extracted from openclaw.json. |
| Automation | Definitions for all active cron jobs and scheduled tasks. |
| Repositories | A manifest of GitHub repos to be re-cloned via the gh CLI during restoration. |
openclaw-teleport Advanced Features
- Metadata inspection allows users to view the contents of a .soul file without performing a full restoration.
- Support for custom workspace pathing to restore agents into non-default directories.
- Automated environment bootstrapping that installs OpenClaw core components if they are not present on the target system.
- Intelligent exclusion of git subdirectories to keep archive sizes manageable while maintaining source control links.
SKILL.md
Loading
Related Openclaw Skills
Xiaoxia Image Gen
A versatile text-to-image skill supporting multiple AI models like MiniMax, DALL-E 3, and Stability AI for seamless visual content creation.
Investment Cognition Detector
A systematic framework to identify cognitive blind spots in investment strategies through a structured four-question model.
Web3 DApp Builder
A professional-grade skill for architecting and building modern Web3 decentralized applications using 2026 industry standards.
Ledger Project Expense Entry
A streamlined utility for converting natural language messages into structured financial ledger entries for project tracking.
Zhihu Ops
A browser automation skill for performing interactive and creative tasks on Zhihu using structured and stable workflows.
Doubao All-in-One
An integrated AI generation suite for creating professional-grade images and videos using the Doubao (Ark) engine with full local file management.
Featured*
