sidebar_position: 10 title: “从 OpenClaw 迁移” description: “完整迁移指南，讲解如何把 OpenClaw / Clawdbot 配置迁移到 Hermes Agent，包括迁移内容、配置映射和迁移后检查项”

从 OpenClaw 迁移

hermes claw migrate 会把你的 OpenClaw（或旧版 Clawdbot/Moldbot）配置导入 Hermes。这篇指南会说明究竟会迁移哪些内容、配置 key 如何映射，以及迁移后应该检查什么。

快速开始

# 先预览再迁移（总是先显示预览，然后请求确认）
hermes claw migrate

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

# 完整迁移，包括 API keys，并跳过确认
hermes claw migrate --preset full --yes

迁移命令在真正写入前，总会先显示一份完整预览，告诉你将导入哪些内容。请先检查列表，再确认继续。

默认从 ~/.openclaw/ 读取。旧版 ~/.clawdbot/ 或 ~/.moltbot/ 目录会被自动识别。旧版配置文件名（clawdbot.json、moltbot.json）也会被识别。

选项

会迁移哪些内容

Persona、memory 和指令

Workspace 文件也会在 workspace.default/ 和 workspace-main/ 中作为 fallback 检查。OpenClaw 在近期版本中曾把 workspace/ 改名为 workspace-main/，并使用 workspace-{agentId} 支持多 agent 设置。

Skills（4 个来源）

Skill 冲突由 --skill-conflict 控制：skip 会保留已有 Hermes skill，overwrite 会覆盖，rename 会创建一个带 -imported 后缀的副本。

模型和 provider 配置

Agent 行为

会话重置策略

注意：OpenClaw 还可能有 session.resetTriggers（例如 ["daily", "idle"] 这样的字符串数组）。如果没有结构化的 session.reset，迁移会回退到从 resetTriggers 推断。

MCP servers

TTS（文本转语音）

TTS 设置会从 OpenClaw 配置中的三个位置读取，优先级如下：

1. messages.tts.providers.{provider}.*（标准位置）
2. 顶层 talk.providers.{provider}.*（fallback）
3. 旧版扁平 key：messages.tts.{provider}.*

消息平台

其他配置

归档内容（没有直接 Hermes 等价物）

这些内容会保存到 ~/.hermes/migration/openclaw/<timestamp>/archive/，供你手动检查：

API key resolution

启用 --migrate-secrets 后，API keys 会按优先级从四个来源收集：

1. 配置值：openclaw.json 中的 models.providers.*.apiKey 和 TTS provider keys
2. 环境文件：~/.openclaw/.env（例如 OPENROUTER_API_KEY、ANTHROPIC_API_KEY）
3. 配置中的 env 子对象：openclaw.json → "env" 或 "env"."vars"（有些安装会把 key 放这里）
4. Auth profiles：~/.openclaw/agents/main/agent/auth-profiles.json（按 agent 存储的凭据）

配置值优先级最高，后续来源只会填补还缺失的 key。

支持的 key 目标

OPENROUTER_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, DEEPSEEK_API_KEY, GEMINI_API_KEY, ZAI_API_KEY, MINIMAX_API_KEY, ELEVENLABS_API_KEY, TELEGRAM_BOT_TOKEN, VOICE_TOOLS_OPENAI_KEY

不在这个 allowlist 中的 key 不会被复制。

SecretRef handling

OpenClaw 配置中的 token 和 API key 可能有三种形式：

// Plain string
"channels": { "telegram": { "botToken": "123456:ABC-DEF..." } }

// Environment template
"channels": { "telegram": { "botToken": "${TELEGRAM_BOT_TOKEN}" } }

// SecretRef object
"channels": { "telegram": { "botToken": { "source": "env", "id": "TELEGRAM_BOT_TOKEN" } } }

迁移会解析这三种格式。对于 env template 和 source: "env" 的 SecretRef 对象，它会从 ~/.openclaw/.env 和 openclaw.json 的 env 子对象中查找真实值。source: "file" 或 source: "exec" 的 SecretRef 无法自动解析，迁移会给出警告，你需要之后用 hermes config set 手动补到 Hermes。

迁移后检查

1. 检查迁移报告：完成后会打印迁移、跳过和冲突项数量。

2. 检查归档文件：~/.hermes/migration/openclaw/<timestamp>/archive/ 中的内容都需要你手动确认。

3. 开启新会话：导入的 skills 和 memory 条目会在新会话中生效，不会影响当前会话。

4. 验证 API keys：运行 hermes status 检查 provider 认证状态。

5. 测试消息平台：如果迁移了平台 token，请重启 gateway：systemctl --user restart hermes-gateway

6. 检查会话策略：确认 hermes config get session_reset 与预期一致。

7. 重新配对 WhatsApp：WhatsApp 使用 QR code 配对（Baileys），无法直接迁移 token。运行 hermes whatsapp 重新配对。

8. 清理归档：确认一切正常后，运行 hermes claw cleanup，把剩余 OpenClaw 目录重命名为 .pre-migration/，避免状态混淆。

故障排查

“OpenClaw directory not found”

迁移会依次检查 ~/.openclaw/、~/.clawdbot/、~/.moltbot/。如果你的安装在别处，请使用 --source /path/to/your/openclaw。

“No provider API keys found”

根据 OpenClaw 版本不同，keys 可能存放在多个位置：openclaw.json 中的 models.providers.*.apiKey、~/.openclaw/.env、openclaw.json 的 "env" 子对象，或 agents/main/agent/auth-profiles.json。迁移会检查这四处。如果 key 使用 source: "file" 或 source: "exec" 的 SecretRef，就无法自动解析，需要通过 hermes config set 手动添加。

迁移后看不到 Skills

导入的 skills 会放到 ~/.hermes/skills/openclaw-imports/。请开启新会话让它们生效，或运行 /skills 检查是否已加载。

TTS voice 没有迁移

OpenClaw 会把 TTS 设置放在两个位置：messages.tts.providers.* 和顶层 talk 配置。迁移会检查两处。如果你的 voice ID 是通过 OpenClaw UI 设置并保存在其他路径，可能需要手动设置：hermes config set tts.elevenlabs.voice_id YOUR_VOICE_ID。