clawdmigrate

核心用法

clawd-migrate 是一款专为 moltbot 和 clawdbot 用户设计的迁移工具，通过 npx clawd-migrate 即可启动交互式向导。工具采用五阶段流水线设计：自动发现现有 bot 资产（记忆文件、配置、clawdbook 凭证）→ 创建带时间戳的完整备份 → 按 openclaw 标准目录结构迁移文件 → 逐文件验证完整性（存在性+大小匹配）→ 自动重装 openclaw 并执行 onboard。支持 CLI 参数灵活控制，如 --no-backup 跳过备份、、--output PATH 自定义输出路径等。

显著优点

数据安全机制完善：强制自动备份+迁移后双重验证，将数据丢失风险降至最低；零配置上手：TUI 交互界面引导全程，无需记忆复杂命令；凭证专项保护：clawdbook/Moltbook 含 API 密钥等敏感数据，单独隔离至 .config/clawdbook// 目录；跨平台兼容：基于 Python 标准库开发，Node.js 14+ 和 Python 3.x 即可运行；开源可审计：MIT 许可证，代码透明。

潜在缺点与局限性

来源可信度受限：T3 级个人开发者作品，无知名组织背书；生态锁定：仅支持 moltbot/clawdbot → openclaw 单向迁移，无法回滚或迁移至其他平台；npm 依赖强制：必须全局安装 openclaw，对拒绝 npm 全局安装的用户不友好；无预览模式：缺少 --dry-run 功能，无法提前查看迁移影响；shell 执行风险：使用 subprocess.run(shell=True)) 执行 npm 命令，虽为功能必需但扩大了攻击面。

适合的目标群体

• 正在使用 moltbot 或 clawdbot 且希望升级至 openclaw 的老用户
• 重视记忆连续性、不愿重新配置身份和工具链的 AI 助手重度用户
• 需要保留 clawdbook/Moltbook 中累积的 API 密钥和项目凭证的开发者
• 具备基础命令行操作能力、能接受 npm 全局安装的技术用户

使用风险

性能风险：大规模记忆文件迁移时，完整备份可能消耗显著磁盘 I/O 和存储空间；依赖风险：npm 全局安装 openclaw 可能因网络、权限或版本冲突失败，导致迁移流程中断；验证盲区：--skip-verify 或 --no-backup 选项会削弱安全保障，非高级用户不建议使用；凭证残留：旧版本配置文件可能残留于原目录，需手动清理以防信息泄露。