📌 本指南基于 Hermes v0.8.x 最后更新：2026-04-14 ⚠️ 非官方站点
👍 你的配置不会丢，迁移只需 3 步。我们帮你一条命令完成换仓。
OpenClaw 迁移指南
使用 hermes claw migrate 一键迁移。附带完整检查清单、常见失败修复和迁移后验证步骤。
迁移前检查清单（10 项）
备份 OpenClaw 配置文件
确认 Hermes 已正确安装
记录当前 API key 列表
确认网络连接稳定
了解当前渠道机器人状态
检查当前 OpenClaw 版本号
确保有终端访问权限
阅读迁移前注意事项
检查磁盘空间是否充足
通知团队成员迁移计划
一键迁移命令
$ hermes claw migrate
🔄 正在读取 OpenClaw 配置...
📤 正在迁移渠道设置...
💼 正在迁移工具配置...
✅ 迁移完成！共迁移 12 项配置。
📤 正在迁移渠道设置...
💼 正在迁移工具配置...
✅ 迁移完成！共迁移 12 项配置。
✓ 迁移成功，你的配置毫无损失
常见失败场景
| 失败现象 | 原因 | 解决方案 |
|---|---|---|
| 提示 "claw 不存在" | OpenClaw 未正确安装或未加入 PATH | 检查 openclaw --version 是否可用 |
| 渠道配置丢失 | 机器人 token 可能已过期 | 重新获取 BotFather / 飞书 token |
| API key 迁移后无法调用 | key 格式不兼容 | 手动检查 ~/.hermes/config.yaml |
| 命令执行到一半卡住 | 网络不稳定或配置文件过大 | 重试或分批迁移 |
迁移后验证清单（5 项）
hermes --version 正常返回
配置文件已迁移至 ~/.hermes/
渠道机器人能正常回复
API 调用测试通过
工具列表与迁移前一致
Hermes vs OpenClaw 对比
| 维度 | Hermes | OpenClaw |
|---|---|---|
| 功能丰富度 | 丰富的内置工具 + MCP 生态 | 基础工具集 |
| 安全与隐私 | 开源可审计，本地优先 | 云端依赖 |
| 社区活跃度 | GitHub 73K+ stars，更新频繁 | 更新较缓 |
| 中文支持 | 社区中文教程丰富 | 中文资料较少 |