Hermes 火了，但大多数人卡在安装这一步：保姆级教程 + OpenClaw 一键迁移

最近 Hermes 很火。

但真正把它装起来的人，没有你想的那么多。

我刚把 Hermes Agent v0.9.0 的关键命令实际跑了一遍：hermes setup、hermes model、hermes doctor、hermes claw migrate 这些路径我都核过了，连一个最容易把新手带沟里的坑也确认了——hermes login 这个命令现在已经被移除，你应该用的是 hermes setup、hermes model 和 hermes auth。

所以这篇文章，我不讲概念，不讲热闹，只解决两件事：

  1. 如果你是第一次装 Hermes，我带你从 0 装到能用。
  2. 如果你以前已经在用 OpenClaw，我带你更稳地迁过去。

很多人现在卡住，不是因为 Hermes 难，而是因为网上有三类内容都不够用：

  • 第一类只会告诉你“很强”，不告诉你第一步点哪里
  • 第二类教程太旧，还在教你走 login 这种已经变掉的路径
  • 第三类只讲安装，不讲迁移，老用户看完还是不敢动

如果你也正卡在这一步，这篇就够了。

先说结论：你真正需要的，不是装上，而是跑通

对小白来说，装上 Hermes 只是开始。 真正会卡住你的，是后面这几件事：

  • 模型怎么接
  • 配置文件在哪里
  • 装完以后怎么验收
  • 遇到旧教程和新命令冲突时该信谁

对 OpenClaw 老用户来说，核心问题更直接：

  • 原来的 skill 会不会冲突
  • 配置能不能平滑迁
  • secrets 要不要一起带过去
  • 迁移完以后怎么确认没出事

好消息是，Hermes 现在已经把这些关键环节补得比较完整了。 尤其重要的一点是：它已经内置了 OpenClaw 迁移工具。

这意味着，你不是非得从头重建。

一、安装前先准备 3 件事

别急着复制命令，先把准备工作做了。

1）确认你的系统环境

Hermes 更适合跑在这些环境里：

  • macOS
  • Linux
  • Windows + WSL

如果你是纯 Windows 用户，又不熟命令行，我建议你直接先装 WSL，再继续下面流程。

2）准备一个可用的模型入口

Hermes 装好以后，不会凭空自己回答你。 它需要一个模型提供方。

最常见的几种是：

  • OpenRouter
  • Anthropic
  • OpenAI Codex
  • 你自己的自定义接口

如果你只是想先跑通，最简单的思路就是： 先准备一个你本来就在用的 provider，后面跟着 hermes model 走。

3）给迁移用户多做一步备份

如果你以前用过 OpenClaw，别上来就迁。 先备份。

这是整篇里最值得你多花 30 秒的一步。

二、第一步：先把 Hermes 装上

官方安装命令直接跑：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

装完以后，不要靠感觉判断成功没有。 直接验证版本：

hermes --version

我本地核到的版本是：

Hermes Agent v0.9.0 (2026.4.13)

如果这里能正常输出版本号，说明安装本身已经完成。

如果你看到的是 command not found，先别慌，常见原因通常只有两个：

  • 当前终端还没刷新
  • shell 环境还没重新加载

最简单的做法就是： 关掉终端，再开一次，然后重新执行 hermes --version。

三、第二步：别再找 login，直接走 setup 和 model

这是现在很多教程最容易误导人的地方。

我实际跑过后确认了：

hermes login

当前会直接提示你，这个命令已经被移除。

它给出的正确方向是：

  • hermes auth：管理凭证
  • hermes model：选择 provider 和默认模型
  • hermes setup：完整初始化

所以如果你是第一次装，最稳的顺序是：

hermes setup

然后再执行：

hermes model

如果你只想手动加一个 API Key，也可以用：

hermes auth add openrouter --type api-key

或者把 openrouter 换成你自己的 provider。

对小白来说，我还是建议你优先走 setup + model，少一点分支，少一点歧义。

四、第三步：把配置位置搞清楚

很多人装完以后慌，是因为不知道配置到底落在哪。

你只要记住这两个命令就行：

hermes config path
hermes config env-path

正常情况下，你会看到：

  • ~/.hermes/config.yaml
  • ~/.hermes/.env

以后你调模型、补环境变量、排查问题，基本都会回到这两个文件。

这一步看起来不起眼，但它能帮你少走很多弯路。

五、第四步：安装完别急着忙，先验收

Hermes 真正好不好用，不在安装那一步，而在验收这一步。

你至少跑下面两个命令：

hermes doctor
hermes status --deep

这两个命令的作用很明确：

  • hermes doctor：看有没有明显配置或依赖问题
  • hermes status --deep：看更完整的组件状态

如果这两步都没有明显报错，你再进入下一步测试。

六、第五步：做一次最小可用测试

现在开始验证它是不是“真的能干活”。

你可以直接进入交互：

hermes

也可以先做一次单次测试：

hermes chat -q "用一句话告诉我，你现在是否工作正常"

只要这里能正常返回，你就已经完成了从“装上”到“跑通”的跨越。

如果这里没返回，优先检查三件事：

  • provider 有没有选对
  • API Key / 凭证有没有加好
  • doctor 里有没有报模型或网络相关问题

七、如果你以前用过 OpenClaw，这里开始做迁移

这一段是给老用户的。

我建议你按下面顺序来，不要省。

1）先看旧目录在不在

默认情况下，OpenClaw 的目录一般在：

~/.openclaw

你可以直接检查：

test -d ~/.openclaw && echo "OpenClaw found" || echo "No OpenClaw found"

如果找不到，说明你可能：

  • 这台机器根本没装过 OpenClaw
  • 旧目录不是默认路径
  • 你以前是通过别的方式跑的

这时候不要硬迁，先把路径搞清楚。

2）先做备份

稳一点，先备份：

mkdir -p ~/work/hermes-migration-backups
cp -R ~/.openclaw ~/work/hermes-migration-backups/openclaw-backup-$(date +%Y%m%d-%H%M%S)

你可以把这一步理解成“后悔药”。 有了它，后面的迁移你心态会完全不一样。

3）先跑 dry-run，只看预览

Hermes 已经内置了迁移命令：

hermes claw migrate --dry-run

如果你的 OpenClaw 目录不是默认位置，就手动指定：

hermes claw migrate --source /你的/openclaw/路径 --dry-run

这一步不要跳。

因为迁移最怕的不是麻烦，而是你根本不知道它准备搬什么。

先看预览，再决定要不要正式执行。

4）正式迁移时，skill 冲突优先用 rename

如果 dry-run 看起来没问题，再正式迁：

hermes claw migrate --skill-conflict rename --yes

为什么我推荐 rename？

因为对大多数老用户来说，最怕的不是多出一个副本，而是新旧 skill 直接覆盖，后面分不清谁是谁。

rename 的默认心智最安全： 先迁进来，保住原件，再慢慢整理。

5）如果你连 secrets 也想带过去，再加这一层

比如你想连部分 API Key 或 bot token 一起迁：

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

但这一步别无脑做。

如果你本来就打算重新整理凭证，或者旧环境里东西比较乱，我反而建议你先不带 secrets，后面手动补，系统会更干净。

6）迁完以后，再做一次验收

hermes doctor
hermes status --all

确认没问题以后，再开始真正使用。

不要今天刚迁完，今天就把旧目录删了。 至少先双轨观察几天。

八、4 个最容易踩的坑，我替你先说了

坑 1：还在看旧教程，去找 hermes login

现在别找了。 这个命令已经被移除。

你应该记住的是：

  • 初次初始化：hermes setup
  • 选模型和 provider：hermes model
  • 手动加凭证：hermes auth add

坑 2：装完 Hermes，就以为已经结束了

没有。

真正的分水岭是： 你有没有完成 doctor、status 和一次最小可用测试。

很多人装上就截图，其实根本还没跑通。

坑 3：迁移时想一步到位，直接覆盖

不建议。

对绝大多数人来说，第一次迁移最稳的思路就是：

  • 先备份
  • 再 dry-run
  • 正式迁移优先 rename
  • 跑稳了再整理

坑 4：以为本地化 = 天然稳定

不是。

本地化只能解决“别把命脉完全托管给云端”这个问题。 它不自动等于你今天装完，明天就永远没坑。

真正稳的是：

  • 配置路径你知道
  • 验收流程你跑过
  • 迁移方式你有回退
  • 遇到问题你知道先查哪里

九、最后给你一个最省事的执行顺序

如果你现在就准备开干，照这个顺序走：

纯新用户

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes --version
hermes setup
hermes model
hermes doctor
hermes status --deep
hermes

OpenClaw 老用户

test -d ~/.openclaw && echo "OpenClaw found" || echo "No OpenClaw found"
mkdir -p ~/work/hermes-migration-backups
cp -R ~/.openclaw ~/work/hermes-migration-backups/openclaw-backup-$(date +%Y%m%d-%H%M%S)
hermes claw migrate --dry-run
hermes claw migrate --skill-conflict rename --yes
hermes doctor
hermes status --all

如果你把这两段真正跑完，你就已经超过大多数还停留在“收藏了 Hermes，迟迟没装”的人了。

结尾

Hermes 这波热度会不会过去，我不知道。

但有一件事我很确定： 如果你真想把 AI 工具接进自己的工作流，那你迟早都要跨过“看热闹”这个阶段，进入“自己装、自己配、自己验收、自己迁移”的阶段。

这篇文章想帮你的，不是多收藏一个新工具。 而是把最容易卡人的那一步，直接带过去。

你先别想着一口吃成胖子。 先把 Hermes 装起来。 先把第一次验收跑通。 如果你以前用过 OpenClaw，再把迁移预览做掉。

走完这一轮，你对 Hermes 的判断，才不再是“别人说它很强”，而是“我自己已经把它跑起来了”。

我是罗老师，一个用 AI 搞事情的人。关注我，看更多“别人不会告诉你”的技术真相。

如果你装到一半卡住，或者你懒得在命令行里反复踩坑，也可以直接找我。闲鱼搜“OpenClaw 远程安装”，30 分钟搞定，装完你亲自验收。

微信：MEM6789022 ｜ 知识星球：罗老师AI智能体