ARTICLE · 1293314

从 OpenClaw 平滑搬家:迁移指南与坑点清单

发布时间：2026-11-01 23:00:59 最近访问：2026-11-01 23:00:59

本篇是「Hermes 数字员工实战系列」第 18 篇

从 OpenClaw 平滑搬家：迁移指南与坑点清单

如果你几个月前就在用 OpenClaw，看到 Hermes 出来可能会纠结：重练一遍？家当怎么办？

不用。OpenClaw 是 Hermes 的前身——同维护者、改名重设计。hermes claw migrate 是一等公民命令（v0.14.0 引入），专门干这事儿。它不是草草导个配置，而是把 SOUL、记忆、技能、MCP、频道 token 整包迁过来。

但"自动"不等于"无脑"。这条命令有几个必须知道的边界和坑。本章给你完整命令表 + 导入映射 + 验证清单，照着跑就行。

铁律：永远先 --dry-run

Hermes 中文桌面版工作台（暗色模式）

*▲ Hermes 中文桌面版工作台（暗色模式）*

hermes claw migrate --dry-run

这一步只预览、不写盘。它会列出要搬什么、映射到哪、哪些会冲突。在没看过 dry-run 输出之前，别去掉 --dry-run。迁移前命令还会自动写一份还原点 ~/.hermes/backups/pre-migration-*.zip，而且它是复制非移动——你的 ~/.openclaw 源目录原样保留，迁坏了也不丢。

完整命令与参数

# 默认 preset=full，含 secrets（API keys）hermes claw migrate# 只看不搬hermes claw migrate --dry-run# 不含 API keys（更保守）hermes claw migrate --preset user-data# 含 API key 一起搬hermes claw migrate --migrate-secrets# 覆盖冲突项hermes claw migrate --overwrite# 指定源目录（默认 ~/.openclaw/，也会自动检测 ~/.clawdbot/ ~/.moltbot/）hermes claw migrate --source /path/to/openclaw# AGENTS.md 需要显式指定目标才导入hermes claw migrate --workspace-target /path# 技能冲突处理hermes claw migrate --skill-conflict skip|overwrite|rename# 全部确认，非交互hermes claw migrate --yes# 稳定后，把遗留 OpenClaw 目录重命名为 .pre-migration/hermes claw cleanup

常用组合，先预览再实跑：

hermes claw migrate --dry-run hermes claw migrate --migrate-secrets --skill-conflict rename --yes

另外提供了一个交互式技能 /openclaw-migration，每步都会先 --dry-run，适合不敢敲命令的人。

导入映射表（你旧家的东西去哪了）

OpenClaw	Hermes 目的地
`workspace/SOUL.md`	`~/.hermes/SOUL.md` （原样）
`workspace/MEMORY.md` / `USER.md` / `memory/*.md`	`~/.hermes/memories/MEMORY.md` / `USER.md`（解析成条目，合并去重，用 `§` 分隔）
`workspace/skills/` 、`~/.openclaw/skills/`、`~/.agents/skills/`	`~/.hermes/skills/openclaw-imports/`
`agents.defaults.model`	`config.yaml → model`
`models.providers.*`	`config.yaml → custom_providers` （baseUrl→api，apiType→chat_completions/anthropic_messages）
provider API keys	`~/.hermes/.env` （需 `--migrate-secrets`）
`agents.defaults.timeoutSeconds/10` （cap 200）	`agent.max_turns`
`agents.defaults.thinkingDefault`	`agent.reasoning_effort`
`tools.exec.timeoutSec`	`terminal.timeout`
`agents.defaults.sandbox.backend/image`	`terminal.backend` / `docker_image`
`session.reset.*`	`session_reset.mode/at_hour/idle_minutes`
`mcp.servers.*`	`mcp_servers.*` （command/args/env/url/tools）
TTS settings	`config.yaml → tts.*` + `~/.hermes/tts/` 资源拷贝
Telegram/Discord/Slack/WhatsApp 频道	`TELEGRAM_BOT_TOKEN` / `DISCORD_BOT_TOKEN` / `SLACK_BOT_TOKEN` / `SLACK_APP_TOKEN` / `*_ALLOWED_USERS` 等 `.env`
`workspace/AGENTS.md`	需 `--workspace-target` 才导入

记忆文件的迁移最值得说：OpenClaw 的 MEMORY.md/USER.md 会被解析成条目、合并去重后写进 Hermes 的 memories/。不是简单覆盖，是融合——你之前教它的事不会丢。

⚠️ 限制与坑（这些不会自动好）

只自动迁主 agent
。OpenClaw 里配了多 agent 的，其余得手动重建。
cron / plugins / hooks / 多 agent 绑定
没有对应项，会被归档到 ~/.hermes/migration/openclaw/<...>/archive/，等你去手动捡回来重建。
agentskills.io 上的技能不会自动重装
。市场里装的技能得重新 hermes skills 选一遍。本地 ~/.openclaw/skills/ 的会进 openclaw-imports/，但远程 tap 的不算。
WhatsApp 需重新 QR 配对
。频道 token 能迁，但 WhatsApp 的登录会话迁不过来，得重新扫一次码。
AGENTS.md 别忘 --workspace-target
。不显式指定，这个文件会被跳过——很多人迁完发现项目上下文没了，就是这个原因。
版本提示
：claw migrate 在 v0.14.0 引入。如果你拉到的 Hermes 比这老，先 hermes update 再迁。

验证清单（迁完必须过一遍）

别迁完就走。按顺序跑，确认每一层都活着：

hermes doctor              # 诊断环境/配置完整性 hermes status              # 当前运行状态 hermes skills list         # 技能是否到位（含 openclaw-imports/） hermes mcp list            # MCP server 是否注册成功

然后每个频道实测一遍：