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

CODEBLOCK0

Or use npx without installing:

CODEBLOCK1

Commands

Pack (export)

CODEBLOCK2

Produces 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 INLINECODE3
• Cron job definitions
• GitHub repo list (re-cloned on unpack)

Unpack (import/restore)

CODEBLOCK3

Unpack automatically:

1. 1. Installs OpenClaw if missing
2. Restores workspace files
3. Writes config + credentials to INLINECODE4
4. Restores cron jobs
5. Clones GitHub repos via INLINECODE5
6. Starts the gateway
7. Prints a welcome summary

Inspect

CODEBLOCK4

Shows 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 INLINECODE7

When to Use

• - Moving to a new machine — pack on old, unpack on new
• Backup — periodic pack to save current state
• Disaster recovery — unpack from a saved .soul file
• Cloning an agent setup — share a .soul file (minus secrets) as a template