需先备份~/.clawdbot/目录，再卸载旧版、清理残留命令，安装Moltbot v2.5.0+，最后手动迁移config.yaml（更新channel/imessage和provider/anthropic）及memories/数据并验证通道与记忆可用性。
如果您当前使用的是 Clawdbot 老版本（如 v1.x 或早期 v2.x），希望升级至最新版 Moltbot（官方已统一命名），需注意命令变更、配置路径调整及本地数据兼容性问题。以下是覆盖安装与关键数据迁移的具体操作步骤：
一、确认当前版本并备份原始配置与记忆数据
升级前必须保留原有配置文件、记忆库（memories/ 目录）及自定义插件，避免功能中断或历史记忆丢失。Clawdbot 的核心状态数据默认存储在用户主目录下的 .clawdbot/ 或 ~/.moltbot/ 中，具体路径取决于安装方式与系统环境。
1、打开终端（macOS/Linux）或 WSL2 Ubuntu（Windows），执行以下命令查看当前版本：
2、运行 clawdbot --version 或 clawdbot version，记录输出结果。
3、执行 ls -la ~/.clawdbot/（或 ~/.moltbot/），确认是否存在 config.yaml、memories/、plugins/ 等关键子目录。
4、将整个 ~/.clawdbot/ 目录复制为备份：
5、运行 cp -r ~/.clawdbot/ ~/.clawdbot-backup-$(date +%Y%m%d)。
二、卸载旧版 Clawdbot 并清理全局命令残留
npm 全局安装的旧版 Clawdbot 可能残留可执行文件与链接，直接覆盖安装易导致命令冲突或权限异常。需彻底清除旧 CLI 二进制引用，确保新版 moltbot 命令能被正确识别。
1、执行 npm uninstall -g clawdbot，移除全局包。
2、检查是否仍有 clawdbot 命令残留：
3、运行 which clawdbot，若返回路径（如 /usr/local/bin/clawdbot），则手动删除该文件：
4、执行 sudo rm /usr/local/bin/clawdbot（macOS/Linux）或 rm C:\Users\用户名\AppData\Roaming\npm\clawdbot.cmd（Windows PowerShell 管理员模式）。
5、验证清理效果：再次运行 clawdbot --version，应提示“command not found”。
三、安装最新版 Moltbot（覆盖式）
自 2026 年起，项目已正式更名为 Moltbot，所有新功能、安全补丁与 iMessage/Telegram 等通道适配均仅面向 moltbot 命令提供。安装过程将自动创建 ~/.moltbot/ 目录，但不会覆盖已有数据，需后续手动迁移。
1、确保 Node.js 版本 ≥ 22.12.0：
2、运行 node --version，若低于 v22.x，则先通过 nvm 升级：
3、执行 nvm install 22 && nvm use 22 && nvm alias default 22。
4、安装 Moltbot 全局 CLI：
5、运行 npm install -g moltbot（推荐）或使用一键脚本：curl -fsSL https://molt.bot/install.sh | bash。
6、验证安装成功：
7、执行 moltbot --version，输出应为 v2.5.0 或更高版本。
四、迁移旧版配置与记忆数据至 Moltbot
Moltbot 默认读取 ~/.moltbot/config.yaml 与 ~/.moltbot/memories/，而旧版 Clawdbot 使用 ~/.clawdbot/config.yaml 与 ~/.clawdbot/memories/。迁移需保持文件结构一致，并校验 YAML 格式兼容性，尤其注意通道字段（如 imsg → imessage）、模型 provider 字段（claude → anthropic）等已变更项。
1、创建新目录结构：
2、运行 mkdir -p ~/.moltbot/{config,memories,plugins}。
3、复制配置文件并重命名：
4、执行 cp ~/.clawdbot/config.yaml ~/.moltbot/config.yaml。
5、手动编辑 ~/.moltbot/config.yaml，将 channel: imsg 替换为 channel: imessage，将 provider: claude 替换为 provider: anthropic。
6、迁移记忆数据：
7、运行 cp -r ~/.clawdbot/memories/* ~/.moltbot/memories/。
五、启动 Moltbot 并验证通道与记忆可用性
完成迁移后，首次启动将触发配置自检与通道握手流程。iMessage、Telegram 等需重新授权，但本地记忆文件无需重建，可立即调用历史上下文。
1、初始化新环境：
2、运行 moltbot onboard，选择 “Use existing config” 跳过向导，直接加载已迁移的 config.yaml。
3、启动服务：
4、执行 moltbot start，观察日志中是否出现 “imessage channel connected” 或 “telegram webhook registered”。
5、发送测试指令（如通过 iMessage 发送 “你记得我上周说过什么吗？”）：
6、检查终端输出是否返回有效记忆片段，确认 memories/ 目录中的 .md 文件被成功加载。
