hermes教程-Nous 工具网关

一个订阅，所有工具内置。

工具网关包含在每份付费 Nous Portal 订阅中。它将 Hermes 的工具调用——网页搜索、图像生成、文本转语音和云浏览器自动化——路由到 Nous 已运行的基础设施上，这样你就不必为了让你的智能体变得有用而分别注册 Firecrawl、FAL、OpenAI、Browser Use 或其他任何服务。

包含内容

所有四项均按使用量计费，从你的 Nous 订阅中扣除。你可以使用任意组合——通过网关运行网页和图像，同时保留你自己的 ElevenLabs 密钥用于 TTS，或者将所有内容都通过 Nous 路由。

为什么存在

构建一个能真正做事情的智能体意味着要拼凑 5 个以上的 API 订阅——每个都有各自的注册、速率限制、计费和怪癖。网关将这一切压缩为一个账户：

• 一张账单。 向 Nous 付费；我们处理其余部分。
• 一次注册。 无需管理 Firecrawl、FAL、Browser Use 或 OpenAI 音频账户。
• 一个密钥。 你的 Nous Portal OAuth 覆盖所有工具。
• 相同质量。 与直接使用密钥路由相同的后端——只是由我们前置。

随时可以自带密钥——按工具，随你心意。网关不是锁定，而是一种捷径。

开始使用

有三种方式接入——选择适合你当前情况的一种：

hermes setup --portal     # 全新安装：Nous OAuth + 设置 Nous 为提供商 + 一键开启工具网关

hermes model              # 将推理提供商切换为 Nous Portal——Hermes 随后会询问是否开启所有工具的网关

hermes tools              # 按工具启用网关——为任何你想使用的工具选择 "Nous Subscription"

hermes setup --portal 和 hermes model 是一步到位的方式：登录一次，可选地将所有工具切换到网关。hermes tools 是点选方式——一次只开启你想要的工具。

你不需要先登录。 使用 hermes tools 时，Nous 管理的后端（网页搜索、图像、视频、TTS、浏览器）始终列出，即使你从未登录过 Nous Portal。选择一个，如果你尚未认证，Hermes 会立即运行 Portal 登录——无需事先运行 hermes model。如果你的 Nous OAuth 已经激活，选择后端会立即启用它，无需额外提示。此路径仅登录并开启你选择的那个工具——它不会切换你的推理提供商，也不会提示你为其他所有工具启用网关。

随时查看当前激活状态：

hermes portal info        # Portal 认证 + 工具网关路由摘要
hermes portal tools       # 网关目录，显示每个工具的当前路由
hermes status             # 完整系统状态（工具网关是其中一部分）

hermes portal info 会显示类似以下部分：

◆ Nous 工具网关
  Nous Portal     ✓ 托管工具可用
  Web 工具        ✓ 通过 Nous 订阅激活
  图像生成        ✓ 通过 Nous 订阅激活
  TTS             ✓ 通过 Nous 订阅激活
  浏览器          ○ 通过 Browser Use 密钥激活

标记为 "通过 Nous 订阅激活" 的工具正在通过网关。其他工具则使用你自己的密钥。

资格

工具网关是一项付费订阅功能。免费版 Nous 账户可以使用 Portal 进行推理，但不包含托管工具——升级你的计划 以解锁网关。

某些账户还有资格获得免费工具池——一个小的托管工具配额，无需付费订阅即可覆盖网关工具调用。当免费池可用时，网关会显示它，并在首次使用时显示设置提示，以便你可以选择加入并立即开始使用托管工具。

混合搭配

网关是按工具设置的。只为你想要的工具开启：

• 所有工具通过 Nous——最简单；一个订阅，搞定。
• 网关用于网页 + 图像，自带 TTS——保留你的 ElevenLabs 声音，让 Nous 处理其余部分。
• 网关仅用于你没有密钥的工具——"我已经为 Browserbase 付费，但我不想注册 Firecrawl 账户" 这样也行。

随时通过以下命令切换任何工具：

hermes tools          # 每个工具类别的交互式选择器

选择工具，然后选择 Nous Subscription 作为提供商（或你喜欢的任何直接提供商）。无需编辑配置。如果你尚未登录 Nous Portal，选择 Nous Subscription 会立即启动 Portal 登录——你不需要先通过 hermes model 进行认证。

使用单个图像模型

图像生成默认使用 FLUX 2 Klein 9B 以获得速度。每次调用时可通过向 image_generate 工具传递模型 ID 来覆盖：

模型集合会不断演变——hermes tools → Image Generation 会显示当前的实时列表。

配置参考

大多数用户永远不需要碰这个——hermes model 和 hermes tools 以交互方式覆盖了所有工作流程。本节适用于直接编写 config.yaml 或脚本化设置。

按工具设置 use_gateway 标志

每个工具的配置块接受一个 use_gateway 布尔值：

web:
  backend: firecrawl
  use_gateway: true

image_gen:
  use_gateway: true

tts:
  provider: openai
  use_gateway: true

browser:
  cloud_provider: browser-use
  use_gateway: true

优先级：use_gateway: true 会通过 Nous 路由，无论 .env 中是否有直接密钥。use_gateway: false（或缺失）会使用直接密钥（如果可用），仅在无密钥时回退到网关。

禁用网关

web:
  use_gateway: false   # Hermes 现在使用 .env 中的 FIRECRAWL_API_KEY

当你选择非网关提供商时，hermes tools 会自动清除该标志，因此这通常会自动完成。

自托管网关（高级）

运行你自己的 Nous 兼容网关？在 ~/.hermes/.env 中覆盖端点：

TOOL_GATEWAY_DOMAIN=your-domain.example.com
TOOL_GATEWAY_SCHEME=https
TOOL_GATEWAY_USER_TOKEN=your-token        # 通常从 Portal 登录自动填充
FIRECRAWL_GATEWAY_URL=https://...         # 专门覆盖一个端点

这些设置适用于自定义基础设施设置（企业部署、开发环境）。常规订阅者无需设置它们。

常见问题

它是否适用于 Telegram / Discord / 其他消息网关？

是的。工具网关在工具执行层运行，而不是 CLI。任何能够调用工具的接口——CLI、Telegram、Discord、Slack、IRC、Teams、API 服务器等——都能透明地受益。

如果我的订阅过期了怎么办？

通过网关路由的工具将停止工作，直到你续费或通过 hermes tools 换用直接 API 密钥。Hermes 会显示一个明确的错误，指向 Portal。

我可以查看每个工具的使用量或费用吗？

可以——Nous Portal 仪表板 按工具细分使用量，以便你了解是什么在驱动你的账单。

Modal（无服务器终端）是否包含在内？

Modal 作为可选附加项通过 Nous 订阅提供，不属于默认工具网关捆绑包。当你需要用于 shell 执行的远程沙箱时，可通过 hermes setup terminal 或直接在 config.yaml 中配置。

启用网关后，我需要删除现有的 API 密钥吗？

不需要——将它们保留在 .env 中。当 use_gateway: true 时，Hermes 会跳过直接密钥并使用网关。将标志改回 false，你的密钥就会再次成为来源。网关不是锁定。