跳到主要内容

Nous 工具网关

开始使用

工具网关包含在付费的 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 生成图像(8 种模型:FLUX 2 Klein/Pro, GPT-Image, Nano Banana Pro, Ideogram, Recraft V4 Pro, Qwen, Z-Image)FAL_KEY
文本转语音通过 OpenAI TTS 将文本转换为语音VOICE_TOOLS_OPENAI_KEY, ELEVENLABS_API_KEY
浏览器自动化通过 Browser Use 控制云浏览器BROWSER_USE_API_KEY, BROWSERBASE_API_KEY

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

资格说明

工具网关面向付费Nous Portal 订阅者开放。免费层级账户无法访问——请升级您的订阅以解锁该功能。

要检查您的状态:

hermes status

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

启用工具网关

在模型设置期间

当您运行 hermes model 并选择 Nous Portal 作为提供商时,Hermes 会自动提示启用工具网关:

Your Nous subscription includes the Tool Gateway.

The Tool Gateway gives you access to web search, image generation,
text-to-speech, and browser automation through your Nous subscription.
No need to sign up for separate API keys — just pick the tools you want.

○ Web search & extract (Firecrawl) — not configured
○ Image generation (FAL) — not configured
○ Text-to-speech (OpenAI TTS) — not configured
○ Browser automation (Browser Use) — not configured

● Enable Tool Gateway
○ Skip

选择 Enable 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 工具网关,而不是使用直接 API 密钥:

  1. 网络工具web_searchweb_extract 使用网关的 Firecrawl 端点
  2. 图像生成image_generate 使用网关的 FAL 端点
  3. TTStext_to_speech 使用网关的 OpenAI Audio 端点
  4. 浏览器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    # Select the tool → choose a direct provider

或在配置中设置 use_gateway: false

web:
backend: firecrawl
use_gateway: false # Now uses FIRECRAWL_API_KEY from .env

当您在 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”(通过 Nous 订阅激活)的工具通过网关路由。拥有自己密钥的工具会显示哪个提供商处于活动状态。

高级:自托管网关

对于自托管或自定义网关部署,您可以通过 ~/.hermes/.env 中的环境变量覆盖网关节点:

TOOL_GATEWAY_DOMAIN=nousresearch.com     # Base domain for gateway routing
TOOL_GATEWAY_SCHEME=https # HTTP or HTTPS (default: https)
TOOL_GATEWAY_USER_TOKEN=your-token # Auth token (normally auto-populated)
FIRECRAWL_GATEWAY_URL=https://... # Override for the Firecrawl endpoint specifically

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

常见问题

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

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

我可以对一些工具使用网关,对其他工具使用直接密钥吗?

可以。use_gateway 标志是针对每个工具的。您可以混合搭配——例如,对网络和图像生成使用网关,对自己的 TTS 使用 ElevenLabs 密钥,对浏览器自动化使用 Browserbase。

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

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

网关是否与消息网关配合使用?

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

是否包含 Modal?

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