Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道

Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道

作品声明:个人观点、仅供参考。

最近 Hermes 的更新里,有一项我觉得特别适合刚接触的朋友。以前给 Hermes 开启联网搜索,绕不开一件事:API Key。想用 Tavily,要去注册 Tavily;想用 Exa,要申请 Exa;Firecrawl、Parallel 也是一样。注册账号、找 Key、复制到 .env,中间任何一步弄错,最后都可能变成一句:

Web Search unavailable

但 v0.20.4 发布之后,Hermes 的 main 分支已经把这套逻辑改得非常激进。现在即使你的电脑上一个 Web Search API Key 都没有,Hermes 也可以直接调用 5 家服务的公共免费通道:

  • Exa
  • Parallel
  • Tavily
  • Firecrawl
  • Keenable

而且这 5 家并不是摆在那里让你自己选一个。Hermes 把它们做成了一个 Keyless Ring(免密钥轮转环):平时轮流使用,某一家碰到 Rate Limit,还会继续往下一家切。先提醒一句:本文研究的是 v0.20.4 之后已经进入 Hermes 当前 main 的新能力。如果你的安装还停留在正式版 v0.20.4,不一定已经包含这套 5 家轮转机制,先确认版本和更新状态再操作。

Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道-平凡之路

以前联网搜索最麻烦的地方,现在直接被砍掉了

Hermes 其实一直有两个联网工具:

  • web_search
  • web_extract

web_search 负责找网页,例如让 Hermes:

搜索今天最新的 AI 新闻

web_extract 则负责把找到的网页正文读回来。过去这两个 Tool 背后必须有一个真正的 Search Provider。例如:

Hermes
   ↓
web_search
   ↓
Tavily
   ↓
互联网

所以真正麻烦的不是 Hermes 会不会搜索,而是下面这一层 Provider 怎么配。新方案在最底下增加了一层:

Hermes
   ↓
Web Search / Extract
   ↓
Keyless Ring
   ↓
Exa / Parallel / Tavily / Firecrawl / Keenable

这 5 家现在都已经具备 Keyless 路径,而且搜索和网页提取两种能力都能进入这套轮转系统。官方还实际跑过 10 条组合路径:

5 个 Provider
×
Search + Extract
=
10 条 Keyless 路径

都拿到了真实结果。这意味着刚装好 Hermes 的时候,不需要先研究哪家的 API Key 怎么申请,就能先把联网能力用起来。

Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道-平凡之路

5 家免费通道不是备用名单,而是会真的轮流工作

这次最有意思的是 Round-robin(轮询)。如果没有配置任何 Web API Key,也没有显式指定某一家 Backend,Hermes 会进入 Keyless Ring。概念上可以理解成:

Exa → Parallel → Tavily → Firecrawl → Keenable → 继续循环

实际启动时从哪一家开始并不是固定的,Hermes 会给每个进程设置轮转起点。所以连续做几次搜索,有可能这一轮由 Exa 服务,下一轮换 Parallel,再下一轮跑到 Tavily。这样做的好处很现实。公共免费接口最大的缺点通常就是限流,一家扛所有请求,很快就可能遇到:

429 Too Many Requests

现在如果当前免费 Provider 被限流,Hermes 不会马上把错误扔给你,而是继续沿着 Ring 往下找。例如:

Exa → 限流
Parallel → 还是限流
Tavily → 成功
返回结果

这种 Failover 还能多跳,并不是只换一次就结束。只有整个 Ring 都不可用,才真正失败。所以"5 个免费通道"的价值,重点不只是多了几个 Provider,而是它们开始互相兜底。

Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道-平凡之路

手把手开启:最简单的方法其实是什么都别配

如果你已经更新到了包含这套功能的版本,第一次测试反而非常简单。先看看当前版本:

hermes --version

如果你使用的是当前 main,对应代码已经包含 Keyless Ring;如果仍然是 v0.20.4 正式版,要先等后续 Release,或者使用你平时采用的 main 更新方式。然后检查以前有没有指定 Web Backend:

hermes config get web.backend

再检查两个单独的能力:

hermes config get web.search_backend
hermes config get web.extract_backend

全新的 Hermes 安装最省事。只要:

  • 没有指定 Web Backend
  • 没有 Tavily / Exa / Parallel / Firecrawl 等 Web API Key

Hermes 就会自动落到 5 家 Keyless Ring。也就是说,这次所谓的"开启",并不是让大家去配置 5 次:

配置 Exa
配置 Parallel
配置 Tavily
配置 Firecrawl
配置 Keenable

恰恰相反。真正的零配置用法就是:

什么 Web Key 都不填
   ↓
Hermes 自动进入 Keyless Ring
   ↓
5 家免费通道轮流工作

这对新用户很友好。

Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道-平凡之路

老用户要特别检查:以前配过 Backend,它会优先于免费 Ring

这里是最容易踩坑的地方。Hermes 的 Web Provider 有明确的优先级,大致可以理解成:

单独指定 search_backend / extract_backend
            ↓
指定 web.backend
            ↓
检测已有 API Key
            ↓
什么都没有
            ↓
5 家 Keyless Ring

所以假设以前配置过:

web:
  backend: "tavily"

那 Hermes 会尊重你的选择,不会因为现在有免费 Ring 就偷偷换走。如果以前写过 TAVILY_API_KEY,并且当前安装处于自动检测状态,Hermes 同样会优先考虑已经配置好的 Keyed Provider。这其实是合理的,因为用户主动配置的付费服务通常意味着更高额度、更稳定、更明确的服务质量。免费 Ring 应该负责"没有配置时也能用",而不是抢走现有配置。

如果就是想测试纯 Keyless Ring,可以先检查原来的 Web 配置。显式设置过共享 Backend 的,可以使用:

hermes config unset web.backend

如果还配置过单独的 Search / Extract Backend,也分别检查:

hermes config unset web.search_backend
hermes config unset web.extract_backend

但如果 .env 里本来就保存着正在使用的 Web API Key,不建议为了测试免费功能随手删掉。现有 Keyed 服务通常更适合长期高频使用,Keyless Ring 更适合零门槛上手和故障兜底。

Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道-平凡之路

不想 5 家轮着跑,也可以只固定一家免费通道

Hermes 这次没有强迫所有人必须使用 Round-robin。打开:

hermes tools

找到 Web Search & Extract,就可以自己选择 Provider。其中 Exa、Parallel、Keenable 这类 Provider 已经区分:

  • Free (keyless)
  • Paid (API key)

选择 Free,相当于告诉 Hermes:我就想使用这一家的匿名免费路径。Tavily 和 Firecrawl 也支持无 Key 的 Keyless 使用。所以有两种完全不同的玩法。第一种适合不想折腾的朋友:

不指定 Provider
   ↓
5 家自动轮转

第二种适合自己测试某一家效果:

hermes tools
   ↓
选择某个免费 Provider
   ↓
优先固定使用它

固定以后,平时不再每次轮换;如果碰到免费端的限流,Hermes 仍然可以利用后面的 Keyless Failover 机制寻找可用通道。所以第一次使用,我建议先不要选,先体验自动 Ring。等真的发现某一家特别适合自己的搜索任务,再考虑固定。

Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道-平凡之路

更实用的是:你已经有 API Key,免费 Ring 依然有用

这一点我一开始也觉得很有意思。假设已经配置了 Tavily API Key,平常所有搜索都走 Tavily。结果某一天 Key 失效,或者 Tavily 临时 5xx。以前:

Tavily 出错
   ↓
web_search 失败
   ↓
整个任务停下来

现在 Hermes 增加了一种 One-shot Keyless Rescue。流程变成:

首选 Tavily
   ↓
本次调用失败
   ↓
5 家免费 Ring 临时救场
   ↓
返回搜索结果

但它有一个非常重要的设计:

只救这一次

下一次 web_search,Hermes 还是先尝试你的 Tavily。它不会因为刚才失败一次,就偷偷把全局 Provider 永久改成某个免费服务。可以理解成:

你的付费 Provider = 主线路
5 家 Keyless Ring = 应急备用线路

这个比单纯的"免费"更有价值。尤其 Cron、长期 Agent、半夜自动任务,一次 API 服务短暂抽风,不一定就要让整个任务跟着失败。默认情况下这套 Rescue 会开启。如果不喜欢这种自动救场,也可以关闭:

web:
  keyless_rescue: false

如果连整个免费 Ring 都不想使用,则可以:

web:
  keyless_fallback: false

关闭 keyless_fallback 后,Keyless Rescue 也会一起失效。

Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道-平凡之路

怎么判断是否成功?我建议做这 3 个检查

第一步可以直接运行:

hermes doctor

新版已经专门改过 Web Tool 的检查逻辑。以前没有 API Key,很容易直接被判断成 Web unavailable。现在 Keyless Provider 真能工作时,Doctor 也应该把这种状态算作可用,而不是继续报一个假警告。

第二步,直接问 Hermes 一个必须联网的问题。例如:

搜索今天 Hermes Agent 的最新消息,给我列出 5 条,并附上标题和摘要。

如果能正常调用 web_search,说明联网入口已经通了。

第三步再试一次网页正文提取:

从刚才的搜索结果中挑一篇,读取完整网页正文并总结重点。

这一步会测试 web_extract。因为这 5 家 Keyless Ring 现在同时覆盖 Search 和 Extract,所以两个 Tool 都应该可以进入免费路线。如果只是偶尔搜一下资料、看新闻、查文档,我觉得做到这里已经够用了。

Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道-平凡之路

免费归免费,有 3 件事还是要提前知道

第一,Keyless 不等于无限。这几家提供的是公共 Free Tier,都会有自己的 Rate Limit。Hermes 能通过 5 家轮转和自动 Failover 把可用性提高很多,但不意味着可以把它当成无限量商业搜索 API。高频生产任务仍然更适合配置自己的 Key。

第二,免费 Ring 是 Last Resort。只要已经明确选了 Provider,或者存在可用的 Web API Key,Hermes 都会尊重原来的配置。它不会为了"免费"擅自把稳定线路换掉。

第三,这套机制目前属于 v0.20.4 之后的 main 更新。如果你运行命令以后发现:

还是提示缺 API Key

先别急着怀疑自己配置错了。第一件事应该检查:

hermes --version

以及当前安装到底有没有包含最近这批 Web Keyless 更新。

Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道-平凡之路

最后把开启方法压缩成 4 步

如果只想最快体验,我建议记住这套流程:

确认 Hermes 已包含最新 Keyless Ring
            ↓
不要设置 Web Backend
            ↓
不配置 Web API Key
            ↓
直接让 Hermes 搜索

Hermes 会自动在:

  • Exa
  • Parallel
  • Tavily
  • Firecrawl
  • Keenable

这 5 家免费通道之间轮转。当前一家遇到限流,就继续往后找;已经有付费 API Key 的用户,也能把这套 Ring 当作单次故障救援。

我觉得这次升级真正降低的,并不只是几块钱的 API 成本。以前一个刚装好 Hermes 的朋友,想让它"去网上查一下",第一步往往不是搜索,而是先打开浏览器研究:

去哪注册?
Key 在哪里?
填哪个文件?
为什么填完还是不可用?

现在理想情况变成:

装好 Hermes
   ↓
直接问

对于一个本来就想成为长期 AI 助手的 Agent 来说,联网搜索终于开始像基础能力,而不是一道必须先做完的配置题。

Hermes 联网搜索终于不用折腾 API Key!手把手教你开启 5 个免费通道-平凡之路


原文链接:https://www.toutiao.com/article/7676324993839464995/