Skip to main content

Nous 工具网关

开始使用

工具网关包含在付费的 Nous Portal 订阅中。管理您的订阅 →

工具网关 使付费 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 工具网关 部分。该部分显示哪些工具通过网关启用，哪些使用直接密钥，以及哪些尚未配置。

启用工具网关​

在模型设置过程中​

当您运行 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

选择 启用工具网关 即可完成设置。

如果您已为某些工具配置了直接 API 密钥，提示将自动调整——您可以选择：

  • 为所有工具启用网关（您原有的密钥保留在 .env 中，但运行时不被使用）
  • 仅为未配置的工具启用网关
  • 完全跳过

通过 hermes tools​

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

hermes tools

选择一个工具类别（网络、浏览器、图像生成或 TTS），然后选择 Nous 订阅 作为提供方。这将在您的配置中设置 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_search 和 web_extract 使用网关的 Firecrawl 端点
  2. 图像生成 —— image_generate 使用网关的 FAL 端点
  3. TTS —— text_to_speech 使用网关的 OpenAI Audio 端点
  4. 浏览器 —— browser_navigate 及其他浏览器工具使用网关的 Browser Use 端点

网关通过您的 Nous Portal 凭据进行身份验证（在 hermes model 后存储于 ~/.hermes/auth.json 中）。

优先级规则​

每个工具首先检查 use_gateway：

  • use_gateway: true → 无论是否存在直接 API 密钥，均通过网关路由
  • use_gateway: false（或未设置）→ 若存在直接密钥则使用，否则回退至网关

这意味着您可以随时在网关与直接密钥之间切换，而无需删除 .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 工具网关 部分显示：

◆ 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)

标记为“通过 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 还是其他任何消息平台，工具网关都会路由工具 API 调用。它在工具运行时层面工作，而非入口层面。

Modal（无服务器终端后端）作为可选附加功能，通过 Nous 订阅提供。它不会由工具网关提示自动启用——请通过 hermes setup terminal 或在 config.yaml 中单独配置。