- name
- openclaw-teleport
- description
- Migrate, backup, or restore an OpenClaw agent workspace to/from a single .soul file. Use when the user wants to move an agent to a new machine, back up their workspace, restore from a backup, or mentions teleport, migration, pack, unpack, .soul files, or "搬家". Wraps the npm package @kagura-agent/openclaw-teleport.
openclaw-teleport
One-command agent migration: pack identity, memory, config, credentials, cron jobs, and workspace into a single .soul archive, then unpack on a new machine for full restoration.
Install
npm install -g @kagura-agent/openclaw-teleportOr use npx without installing:
npx @kagura-agent/openclaw-teleport packCommands
Pack (export)
# Pack the default (first) agent
openclaw-teleport pack
# Pack a specific agent by name
openclaw-teleport pack kaguraProduces a <name>_<date>.soul file (tar.gz) containing:
- Full workspace (identity files, memory, skills, workflows, databases — excluding git repo subdirectories)
- Agent config + channel credentials from
openclaw.json - Cron job definitions
- GitHub repo list (re-cloned on unpack)
Unpack (import/restore)
# Restore to default workspace (~/.openclaw/workspace)
openclaw-teleport unpack kagura_20260320.soul
# Restore to a custom workspace
openclaw-teleport unpack kagura_20260320.soul --workspace /path/to/workspaceUnpack automatically:
- Installs OpenClaw if missing
- Restores workspace files
- Writes config + credentials to
openclaw.json - Restores cron jobs
- Clones GitHub repos via
gh - Starts the gateway
- Prints a welcome summary
Inspect
openclaw-teleport inspect kagura_20260320.soulShows manifest metadata without unpacking: agent name, pack date, file count, repos, channels, cron jobs.
Security
⚠️ .soul files contain plaintext credentials (API tokens, bot tokens, app secrets). Treat them like password files:
- Never commit to git or share publicly
- Transfer via encrypted channels (SSH, encrypted USB)
- Delete after unpacking
- Optionally encrypt with
gpg -c agent.soul
When to Use
- Moving to a new machine — pack on old, unpack on new
- Backup — periodic
packto save current state - Disaster recovery —
unpackfrom a saved.soulfile - Cloning an agent setup — share a
.soulfile (minus secrets) as a template