Migrate

📦 一键迁移,完整保留 WhatsApp 登录

一键迁移 Clawdbot 到新设备,完整保留工作空间、配置和 WhatsApp 登录状态,支持安全备份与恢复。

收藏
5.5k
安装
2.3k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Clawdbot 迁移技能提供完整的跨设备迁移解决方案,通过 export.shimport.sh 两个脚本实现环境的无缝转移。

导出操作:运行 bash scripts/export.sh 生成带时间戳的压缩包,支持自定义输出路径、工作空间位置,可选包含会话记录(--include-sessions)或敏感凭证(--include-credentials)。

导入操作:在新机器执行 bash scripts/import.sh <archive.tar.gz>,自动解压并恢复工作空间、配置文件、已安装技能及 WhatsApp 会话状态,支持 --force 强制覆盖。

迁移工作流:旧机器导出 → 传输归档文件 → 新机器全局安装 clawdbot → 执行导入 → 启动网关。WhatsApp 会话随迁移自动生效,无需重新扫码登录。

显著优点

1. 零配置迁移:自动识别并打包核心组件(~/clawd 工作空间、clawdbot.json 配置、托管技能、WhatsApp 会话),排除可重建的缓存目录
2. 会话连续性:WhatsApp 登录状态完整保留,避免重新配对二维码的繁琐流程

3. 灵活可控:通过 flags 精细控制敏感数据(凭证、会话记录)的包含与否

4. 标准工具链:基于 tar.gz 和 bash 脚本,无额外依赖,兼容主流 Unix-like 系统

潜在缺点与局限性

  • 平台限制:依赖 bash 环境,Windows 原生支持需 WSL 或 Git Bash
  • 凭证安全--include-credentials 明文打包敏感信息,需用户自行承担泄露风险
  • 版本兼容性:未明确说明跨版本迁移的兼容性处理
  • 传输安全:归档文件传输过程无加密要求,依赖用户自选渠道(scp/USB/云盘)的安全性
  • 大体积工作空间:若包含大量媒体文件,归档体积可能显著膨胀

适合人群

  • 更换工作机或重装系统的 Clawdbot 用户
  • 需要定期环境备份的运维人员
  • 多设备同步开发环境的开发者
  • 希望保留 WhatsApp 登录状态避免重复扫码的用户

常规风险

| 风险项 | 说明 | 缓解建议 |
|--------|------|----------|
| 凭证泄露 | `--include-credentials` 打包明文敏感信息 | 仅在可信环境启用,传输后删除归档 |
| 会话劫持 | 包含 WhatsApp 会话的归档若被截获可能导致账户风险 | 使用加密传输通道,避免公共云盘直传 |
| 数据覆盖 | `--force` 导入可能误删现有工作空间 | 导入前确认目标路径无重要数据 |
| 版本冲突 | 新旧机器 clawdbot 版本不一致可能导致兼容性问题 | 迁移前统一升级至最新版本 |

Migrate 内容

scripts文件夹
手动下载zip · 5.4 kB
export.shtext/x-shellscript
请选择文件