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. Installs OpenClaw if missing
- Restores workspace files
- Writes config + credentials to INLINECODE4
- Restores cron jobs
- Clones GitHub repos via INLINECODE5
- Starts the gateway
- 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
技能名称: openclaw-teleport
详细描述:
openclaw-teleport
一键式智能体迁移：将身份、记忆、配置、凭证、定时任务和工作空间打包成一个单一的 .soul 存档文件，然后在新机器上解包以完全恢复。
安装
bash
npm install -g @kagura-agent/openclaw-teleport
或者使用 npx 无需安装：
bash
npx @kagura-agent/openclaw-teleport pack
命令
打包（导出）
bash
打包默认（第一个）智能体
openclaw-teleport pack
按名称打包指定智能体
openclaw-teleport pack kagura
生成一个 <名称>_<日期>.soul 文件（tar.gz 格式），包含：
- - 完整工作空间（身份文件、记忆、技能、工作流、数据库——排除 git 仓库子目录）
- 来自 openclaw.json 的智能体配置 + 渠道凭证
- 定时任务定义
- GitHub 仓库列表（解包时重新克隆）
解包（导入/恢复）
bash
恢复到默认工作空间（~/.openclaw/workspace）
openclaw-teleport unpack kagura_20260320.soul
恢复到自定义工作空间
openclaw-teleport unpack kagura_20260320.soul --workspace /path/to/workspace
解包自动执行：
- 1. 如果缺少 OpenClaw 则安装
- 恢复工作空间文件
- 将配置 + 凭证写入 openclaw.json
- 恢复定时任务
- 通过 gh 克隆 GitHub 仓库
- 启动网关
- 打印欢迎摘要
检查
bash
openclaw-teleport inspect kagura_20260320.soul
显示清单元数据而不解包：智能体名称、打包日期、文件数量、仓库、渠道、定时任务。
安全性
⚠️ .soul 文件包含明文凭证（API 令牌、机器人令牌、应用密钥）。请像对待密码文件一样对待它们：
- - 切勿提交到 git 或公开分享
- 通过加密渠道传输（SSH、加密 USB）
- 解包后删除
- 可选择使用 gpg -c agent.soul 进行加密
使用场景
- - 迁移到新机器 — 在旧机器上打包，在新机器上解包
- 备份 — 定期执行 pack 以保存当前状态
- 灾难恢复 — 从保存的 .soul 文件执行 unpack
- 克隆智能体设置 — 分享 .soul 文件（不含密钥）作为模板
