实战：从 OpenClaw 迁移过来

这篇教程将手把手教你如何把 OpenClaw（或旧版 Clawdbot/Moldbot）的配置、记忆、技能和聊天平台设置，一键迁移到 Hermes Agent，就像搬家时请了个专业搬家公司，帮你把家具、书本和杂物分门别类地打包好。

---

第1步：先看看要搬什么（预览）

迁移前，Hermes 会先给你看一份“搬家清单”，列出所有将被导入的内容，确认无误后才动手。运行以下命令：

# 预览并迁移（先显示清单，再询问是否继续）
hermes claw migrate

# 只预览，不做任何更改
hermes claw migrate --dry-run

小贴士：如果你之前用的是 Claude Code 或 OpenAI Codex CLI，请改用 hermes import-agent 命令。

---

第2步：选择搬家方式（预设）

Hermes 提供两种“搬家套餐”：

• full：迁移所有兼容设置（但不含 API 密钥）
• user-data：只迁移个人数据，跳过基础设施配置

# 完整迁移，包含 API 密钥，跳过确认
hermes claw migrate --preset full --migrate-secrets --yes

注意：无论选哪个套餐，默认都不会导入 API 密钥。需要显式加上 --migrate-secrets 参数，就像搬家时特别叮嘱“别忘了保险柜里的钥匙”。

---

第3步：检查关键配置的“新家”

迁移后，你的设置会映射到 Hermes 的新位置。以下是几个重要对照：

原 OpenClaw 配置	Hermes 新位置	说明
workspace/SOUL.md（人设）	~/.hermes/SOUL.md	直接复制
workspace/MEMORY.md（长期记忆）	~/.hermes/memories/MEMORY.md	自动解析、去重、合并
agents.defaults.model（默认模型）	config.yaml 的 model 字段	支持字符串或 {primary, fallbacks} 对象
agents.defaults.timeoutSeconds	agent.max_turns	除以 10，上限 200
mcp.servers.*（MCP 服务器）	mcp_servers.*	字段一一对应

技能文件（相当于你的“工具箱”）会统一搬到 ~/.hermes/skills/openclaw-imports/。如果新旧技能重名，可用 --skill-conflict 参数选择：skip（保留旧的）、overwrite（覆盖）、rename（重命名加 -imported 后缀）。

---

第4步：迁移聊天平台（Telegram/Discord 等）

你的聊天机器人账号（Telegram、Discord、Slack 等）的令牌和允许用户列表，会写入 Hermes 的 .env 文件。例如：

• Telegram 机器人令牌 → TELEGRAM_BOT_TOKEN
• Discord 令牌 → DISCORD_BOT_TOKEN
• 允许的用户列表 → TELEGRAM_ALLOWED_USERS（逗号分隔）

注意：这些令牌属于敏感信息，同样需要 --migrate-secrets 参数才会迁移。

---

第5步：迁移后检查

迁移完成后，建议检查以下几点：

1. 人设和记忆：确认 ~/.hermes/SOUL.md 和 ~/.hermes/memories/MEMORY.md 内容完整
2. 模型配置：打开 ~/.hermes/config.yaml，确认模型、推理强度、压缩等设置正确
3. 技能文件：查看 ~/.hermes/skills/openclaw-imports/ 是否包含所有技能
4. 聊天平台：检查 .env 中的令牌是否正确

小提示：迁移前 Hermes 会自动备份当前配置（~/.hermes/backups/pre-migration-*.zip），万一出错可用 hermes import 恢复。

---

总结

从 OpenClaw 迁移到 Hermes 就像换新家：先看清单（预览）、选套餐（预设）、搬家具（配置映射）、装钥匙（API 密钥）、最后检查水电（验证）。整个过程安全可逆，默认不碰你的 API 密钥，技能冲突也有三种处理方式。

下篇预告：迁移完成后，如何用 Hermes 的 Nous Portal 一个登录搞定 300+ 模型？下一篇我们聊聊“多模型自由切换”的实战技巧。