核心功能
clawd-migrate 是一款专为 openclaw 生态设计的迁移工具，帮助用户从旧版 moltbot 或 clawdbot 无缝升级至新版 openclaw 框架。该工具采用发现-备份-迁移-校验-重装的五步流水线，确保用户的核心资产零损失迁移。
显著优点
1. 资产自动发现：智能扫描现有 bot 目录结构，识别记忆文件（SOUL.md、USER.md、TOOLS.md 等）、配置文件及凭证数据
2. 零风险备份：迁移前自动生成带时间戳的完整备份，支持 --no-backup 跳过但强烈不建议
3. 完整性校验：迁移后对每个文件执行存在性+大小匹配双验证，杜绝静默损坏
4. 一键重装集成：自动执行 npm i -g openclaw 与 openclaw onboard，缩短上线时间
5. 交互友好：默认启动菜单式引导，降低 CLI 工具使用门槛
潜在局限
- Node.js 14+ / Python 3.x 双依赖：环境要求较旧版 bot 更严格
- 仅支持官方路径结构：自定义目录布局需手动调整
--root参数 - 凭证明文迁移：Clawdbook/Moltbook 的 API 密钥以原格式迁移，无额外加密层
- npx 执行信任链：依赖 npm registry 安全性，建议锁定版本号
适合人群
- 正在使用
moltbot或clawdbot的老用户 - 需要保留长期记忆与身份配置的团队/个人
- 追求可验证、可回滚迁移流程的谨慎型用户
常规风险
- 备份占用双倍磁盘空间（迁移期间）
- 若原配置存在语法错误，迁移后仍携带至新环境
- 跨版本 API 兼容性需后续手动验证，工具本身不修复配置语法