AI创业内参
Agent工坊

【Agent工坊】从OpenClaw一键迁移到Hermes Agent：完整实操指南

AI创业内参

Hermes Agent发布官方迁移工具，一条命令完成模型/Agent/频道全量迁移，自动备份+自动检测配置。110人HN热榜验证，这是目前最丝滑的AI Agent平台切换方案。

背景：为什么现在该考虑迁移？

如果你一直在用OpenClaw（或早期的Clawdbot/Moldbot）搭建AI Agent，你应该注意到一个趋势：Hermes Agent正在从"替代品"升级为"迁移目标"。

我们来看两组数据：

维度 Hermes Agent OpenClaw
最新版本 v0.16.0 Surface（6月5日） v2026.6.8（6月16日）
桌面App ✅ 原生桌面应用（拖拽文件/命令面板） ❌ 无官方桌面App
模型支持 300+模型 + Tool Gateway + OAuth 有限provider直连
迁移工具 ✅ hermes migrate openclaw ❌ 无反向迁移
HN社区热度 110分（迁移指南） —

关键信号：Hermes主动推出迁移工具，说明它不再满足于共存——它在用"零切换成本"策略争夺OpenClaw用户群。这对我们一人公司创业者意味着：切换成本从未这么低。

迁移工具能做什么？

hermes migrate openclaw 不是简单的配置导出导入，它是一个完整的迁移引擎。迁移范围覆盖三大核心层：

1. 模型配置层

  • 自动读取OpenClaw的API keys和provider配置
  • 多provider映射到Hermes的单一OAuth Gateway（300+模型统一管理）
  • 支持多provider合并（例如：你之前分别配了OpenAI Key和Anthropic Key，迁移后统一通过Hermes Gateway路由）

2. Agent配置层

  • tool usage配置（允许/禁止哪些工具）
  • memory配置（会话记忆/长期记忆策略）
  • Agent behavior规则（system prompt / skill设置）

3. 频道配置层

  • Telegram / WhatsApp / Discord等消息频道配置
  • Webhook地址和认证信息
  • 消息路由规则

三步完成迁移（附完整命令）

第1步：安装Hermes Agent

# macOS
brew install nousresearch/hermes/hermes-agent

# Linux (via install script)
curl -fsSL https://get.hermes-agent.com | bash

# Docker
docker pull nousresearch/hermes-agent:latest

验证安装：

hermes version
# 应输出: hermes-agent v0.16.0 (Surface)

第2步：预览迁移内容

不要直接执行迁移！ 先用preview模式查看会迁移什么：

hermes migrate openclaw --dry-run

输出示例：

🔍 Scanning for OpenClaw configs...
  Found: ~/.openclaw/config.yaml (v2026.6.8)
  Found: ~/.openclaw/models.yaml (3 providers)
  Found: ~/.openclaw/channels/telegram.yaml
  Found: ~/.openclaw/channels/discord.yaml

📋 Migration Preview:
  Models:   3 providers → 1 OAuth Gateway
  Agents:   2 agent configs → Hermes agent profiles
  Channels: 2 channels (Telegram, Discord) → Hermes channels
  Memory:   short-term memory config → Hermes memory stack

  ⚠️  Note: Discord webhook需要手动验证（见FAQ第4条）

Total items to migrate: 7
Ready to migrate? Run: hermes migrate openclaw --execute

第3步：执行迁移

hermes migrate openclaw --execute

迁移引擎会按以下顺序执行：
1. 创建恢复归档 — ~/.hermes/migration/backup-2026-06-19.tar.gz
2. 迁移模型配置 — API keys合并到Gateway，provider映射自动转换
3. 迁移Agent配置 — 创建对应的Hermes agent profiles
4. 迁移频道 — Telegram/WhatsApp/Discord配置迁移
5. 验证 — 检查所有配置是否可正常工作

如果任何步骤失败，会自动回滚到迁移前的状态。

配置文件变化详解

迁移后，你的目录结构会发生这些变化：

迁移前 (OpenClaw):
~/.openclaw/
├── config.yaml          # 主配置（模型 + Agent）
├── models.yaml          # 多provider API keys
├── channels/
│   ├── telegram.yaml
│   └── discord.yaml
└── memory/
    └── short_term.yaml

迁移后 (Hermes):
~/.hermes/
├── hermes.yaml          # 统一配置
├── gateway.yaml         # OAuth Gateway（合并所有模型）
├── profiles/
│   ├── default.yaml     # Agent配置1
│   └── assistant.yaml   # Agent配置2
├── channels/
│   ├── telegram.yaml
│   └── discord.yaml
└── migration/
    └── backup-2026-06-19.tar.gz  # 恢复归档

关键变化：多provider变成了单一Gateway。这意味着你不再需要分别管理OpenAI Key、Anthropic Key、Gemini Key——它们通过Hermes Tool Gateway统一路由，自动选择最优模型。

迁移后验证清单

完成后，运行以下5项检查确保一切正常：

# 1. 检查Gateway连接
hermes gateway status
# 预期: ✅ Gateway connected (300+ models available)

# 2. 验证模型可用
hermes model list
# 预期: 列出所有可用模型（claude-opus-4, gpt-4o, gemini-pro等）

# 3. 测试Agent响应
hermes chat "Hello, are you working?"
# 预期: Agent正常回复

# 4. 检查频道连接
hermes channel status
# 预期: Telegram ✅ | Discord ✅

# 5. 验证工具访问
hermes tool list
# 预期: 列出所有可用工具（filesystem, web_search, terminal等）

常见问题（4个高频FAQ）

Q1: 迁移后OpenClaw配置会被删除吗？
不会。Hermes只读取配置，OpenClaw原配置文件保持不变。你可以随时切回OpenClaw。恢复归档也在~/.hermes/migration/里。

Q2: 多provider合并到Gateway后，如何指定用哪个模型？
Hermes Gateway会根据任务类型自动路由（代码任务→Claude，创意写作→GPT-4o，长上下文→Gemini），你也可以手动指定：

hermes chat --model claude-opus-4 "分析这个代码库"

Q3: Docker环境怎么迁移？
Docker用户需要在容器内部执行迁移。如果OpenClaw配置在宿主机，先挂载：

docker run -v ~/.openclaw:/tmp/openclaw-config \
  hermes-agent migrate openclaw --config-path /tmp/openclaw-config

Q4: Discord/Telegram频道迁移后需要重新授权吗？
Telegram Bot Token会自动迁移，无需重新授权。Discord需要重新走OAuth流程（因为Hermes使用不同的应用ID）：

hermes channel setup discord
# 按提示完成OAuth授权

迁移 vs 重新配置：哪个更适合你？

场景 建议
已有复杂OpenClaw配置（3+频道、多个Agent） 用迁移工具，省时省力
只有一个Telegram Bot + 简单配置 直接重新配置Hermes，10分钟搞定
需要保留OpenClaw同时试用Hermes 平行运行，不用迁移
想彻底切到Hermes 迁移 + 1周后删除OpenClaw

行动建议

今天就能做的3件事：

  1. 15分钟：安装Hermes，跑一遍 hermes migrate openclaw --dry-run，看看你的配置有多少会被迁移
  2. 1小时：挑一个Agent配置完成完整迁移，在测试频道验证各项功能
  3. 本周：如果确认好用，把老Agent全部迁移过来，享受桌面App + 300+模型Gateway的便利

AI创业 #HermesAgent #OpenClaw #Agent迁移 #一人公司