核心用法
clawd-migrate 是一款专为 moltbot 与 clawdbot 用户设计的迁移工具，目标平台为 openclaw。执行 npx clawd-migrate 即可启动交互式向导，流程涵盖：
1. Discover：扫描系统定位既有资产（记忆文件、配置目录、clawdbook/Moltbook 凭据）
2. Backup：迁移前创建带时间戳的完整备份
3. Migrate：将文件按 openclaw 目录结构重组（memory/、.config/openclaw/、.config/clawdbook/）
4. Verify：逐文件校验存在性与大小匹配，确保零丢失
5. Reinstall：自动执行 npm i -g openclaw 与 openclaw onboard 完成环境重建
CLI 支持子命令独立调用（discover、backup、migrate），并允许指定 --root 路径、--output 目录，以及跳过备份或自动安装 openclaw 等选项。
显著优点
- 零配置风险：强制备份机制，任何操作前均保留可恢复快照
- 数据完整性保障：校验环节确保源文件与目标文件一一对应，防止静默丢失
- 跨系统兼容：基于 Node.js 与 Python 3，不依赖特定操作系统
- 全资产覆盖：不仅迁移运行时配置，还保留 SOUL.md、IDENTITY.md 等身份记忆文件，以及 API 凭据
潜在缺点与局限性
- 版本锁定：要求 Node.js 14+ 与 Python 3.x，旧环境需先升级
- 单向迁移：文档未提及回滚流程，若 openclaw 不兼容旧数据格式，恢复至原 bot 需手动操作
- 闭源生态依赖：涉及
clawdbook/moltbook等私有配置格式，若上游 schema 变更，工具可能滞后 - 权限风险：需要读取用户 home 目录下的隐藏配置（
.config/*），在受限环境（如 CI、容器）可能权限不足
适合人群
- 现有 moltbot/clawdbot 用户计划迁移至 openclaw 生态
- 需要保留长期记忆与身份设定的个人 AI 助手用户
- 重视数据安全、希望在迁移前获得可验证备份的技术用户
常规风险
- 凭据泄露：迁移过程涉及读取 API key 与凭证文件，备份目录若权限设置不当或上传至公有云，可能导致敏感信息外泄
- 数据覆盖：虽默认强制备份，但
--no-backup选项一旦误用，可能直接覆盖目标目录现有数据 - npm 供应链：自动重装 openclaw 依赖 npm registry，若遭遇域名劫持或依赖混淆攻击，可能引入恶意代码
- 验证盲区：校验仅比对文件存在性与大小，不校验内容哈希，极端情况下可能存在字节级损坏未被发现