核心用法
Clawdbot 迁移技能提供完整的跨设备迁移解决方案,通过 export.sh 和 import.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 版本不一致可能导致兼容性问题 | 迁移前统一升级至最新版本 |