Nous Tool Gateway

开始使用

Tool Gateway 包含在付费的 Nous Portal 订阅中。管理你的订阅 →

Tool Gateway 让付费的 Nous Portal 订阅用户可以通过现有订阅使用网络搜索、图像生成、文本转语音和浏览器自动化功能——无需再为 Firecrawl、FAL、OpenAI 或 Browser Use 单独申请 API 密钥。

包含哪些工具

工具	功能说明	直接替代方案
网络搜索与提取	通过 Firecrawl 搜索网络并提取页面内容	`FIRECRAWL_API_KEY`、`EXA_API_KEY`、`PARALLEL_API_KEY`、`TAVILY_API_KEY`
图像生成	通过 FAL 生成图像（9 种模型：FLUX 2 Klein/Pro、GPT-Image 1.5/2、Nano Banana Pro、Ideogram V3、Recraft V4 Pro、Qwen、Z-Image Turbo）	`FAL_KEY`
文本转语音	通过 OpenAI TTS 将文本转换为语音	`VOICE_TOOLS_OPENAI_KEY`、`ELEVENLABS_API_KEY`
浏览器自动化	通过 Browser Use 控制云端浏览器	`BROWSER_USE_API_KEY`、`BROWSERBASE_API_KEY`

所有四种工具均从你的 Nous 订阅中计费。你可以启用任意组合——例如，使用网关进行网络搜索和图像生成，同时保留自己的 ElevenLabs 密钥用于 TTS。

使用资格

Tool Gateway 仅面向付费的 Nous Portal 订阅用户开放。免费版账户无法使用——升级你的订阅即可解锁。

要查看你的状态：

hermes status

查找 Nous Tool Gateway 部分。它会显示哪些工具通过网关激活、哪些使用直接密钥、以及哪些尚未配置。

启用 Tool Gateway

在模型设置期间

当你运行 hermes model 并选择 Nous Portal 作为提供商时，Hermes 会自动提供启用 Tool Gateway 的选项：

你的 Nous 订阅包含 Tool Gateway。

  Tool Gateway 让你可以通过 Nous 订阅使用网络搜索、图像生成、
  文本转语音和浏览器自动化功能。
  无需单独申请 API 密钥——只需选择你想要的工具即可。

  ○ 网络搜索与提取（Firecrawl）——未配置
  ○ 图像生成（FAL）——未配置
  ○ 文本转语音（OpenAI TTS）——未配置
  ○ 浏览器自动化（Browser Use）——未配置

  ● 启用 Tool Gateway
  ○ 跳过

选择 启用 Tool Gateway 即可完成。

如果你已经拥有某些工具的直接 API 密钥，提示会相应调整——你可以为所有工具启用网关（你现有的密钥会保留在 .env 中，但运行时不会使用），仅对未配置的工具启用，或完全跳过。

通过 `hermes tools`

你也可以通过交互式工具配置逐个启用网关工具：

hermes tools

选择一个工具类别（Web、Browser、Image Generation 或 TTS），然后选择 Nous Subscription 作为提供商。这会在你的配置中为该工具设置 use_gateway: true。

手动配置

直接在 ~/.hermes/config.yaml 中设置 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 时，运行时会将 API 调用路由到 Nous Tool Gateway，而不是直接使用 API 密钥：

Web 工具 — web_search 和 web_extract 使用网关的 Firecrawl 端点
图像生成 — image_generate 使用网关的 FAL 端点
TTS — text_to_speech 使用网关的 OpenAI Audio 端点
浏览器 — browser_navigate 和其他浏览器工具使用网关的 Browser Use 端点

网关使用你的 Nous Portal 凭据进行身份验证（这些凭据在运行 hermes model 后存储在 ~/.hermes/auth.json 中）。

优先级

每个工具会先检查 use_gateway：

use_gateway: true → 通过网关路由，即使 .env 中存在直接 API 密钥
use_gateway: false（或未设置）→ 如果可用则使用直接 API 密钥，仅在无直接密钥时回退到网关

这意味着你可以在任何时候在网关和直接密钥之间切换，而无需删除 .env 中的凭据。

切换回直接密钥

要停止对某个特定工具使用网关：

hermes tools    # 选择该工具 → 选择一个直接提供商

或者在配置中设置 use_gateway: false：

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

当你在 hermes tools 中选择非网关提供商时，use_gateway 标志会自动设置为 false，以防止配置冲突。

检查状态

hermes status

Nous Tool Gateway 部分会显示：

◆ Nous Tool Gateway
  Nous Portal   ✓ managed tools available
  Web tools       ✓ active via Nous subscription
  Image gen       ✓ active via Nous subscription
  TTS             ✓ active via Nous subscription
  Browser         ○ active via Browser Use key
  Modal           ○ available via subscription (optional)

标记为 "active via Nous subscription" 的工具会通过网关路由。使用自己密钥的工具会显示哪个提供商处于活动状态。

高级：自托管网关

对于自托管或自定义网关部署，你可以通过 ~/.hermes/.env 中的环境变量覆盖网关端点：

TOOL_GATEWAY_DOMAIN=nousresearch.com     # 网关路由的基础域名
TOOL_GATEWAY_SCHEME=https                 # HTTP 或 HTTPS（默认：https）
TOOL_GATEWAY_USER_TOKEN=your-token        # 身份验证令牌（通常自动填充）
FIRECRAWL_GATEWAY_URL=https://...         # 专门覆盖 Firecrawl 端点

无论订阅状态如何，这些环境变量始终在配置中可见——它们适用于自定义基础设施设置。

常见问题

我需要删除现有的 API 密钥吗？

不需要。当设置了 use_gateway: true 时，运行时会跳过直接 API 密钥，通过网关路由。你的密钥会原封不动地保留在 .env 中。如果你之后禁用了网关，它们会自动被再次使用。

我能否对部分工具使用网关，对其他工具使用直接密钥？

可以。use_gateway 标志是按工具设置的。你可以混合搭配——例如，对网页和图像生成使用网关，对 TTS 使用你自己的 ElevenLabs 密钥，对浏览器自动化使用 Browserbase。

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

通过网关路由的工具将停止工作，直到你续订订阅或通过 hermes tools 切换到直接 API 密钥。

网关是否与消息网关兼容？

是的。无论你使用的是 CLI、Telegram、Discord 还是其他任何消息平台，Tool Gateway 都会路由工具 API 调用。它在工具运行时层面运行，而不是在入口点层面。

Modal（无服务器终端后端）作为可选附加组件通过 Nous 订阅提供。它不会由 Tool Gateway 提示启用——请通过 hermes setup terminal 或在 config.yaml 中单独配置。

包含哪些工具​

使用资格​

启用 Tool Gateway​

在模型设置期间​

通过 hermes tools​

手动配置​

工作原理​

优先级​

切换回直接密钥​

检查状态​

高级：自托管网关​

常见问题​

我需要删除现有的 API 密钥吗？​

我能否对部分工具使用网关，对其他工具使用直接密钥？​

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

网关是否与消息网关兼容？​

Modal 包含在内吗？​