跳到主要内容

Nous Tool Gateway（工具网关）

快速开始

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

Tool Gateway 让已付费的 Nous Portal 用户通过同一份订阅，直接使用网页搜索、文生图、语音合成（TTS）与浏览器自动化，而不必再分别注册 Firecrawl、FAL、OpenAI、Browser Use 等服务的 API Key。

包含能力​

工具作用若不用网关，可改用
网页搜索与抓取通过 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 订阅计费。你可以按需组合——例如网页与文生图走网关，TTS 仍使用自己的 ElevenLabs Key。

资格与账号​

Tool Gateway 仅对 付费 Nous Portal 订阅开放；免费档不可用——请 升级订阅 后解锁。

检查当前状态：

hermes status

在输出中找到 Nous Tool Gateway 小节：会标明哪些工具经订阅网关启用、哪些使用直连 Key、哪些尚未配置。

如何启用 Tool Gateway​

在模型配置流程中​

运行 hermes model 并选择 Nous Portal 作为提供商时，Hermes 会主动询问是否启用 Tool Gateway：

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 即可。

若 .env 中已有部分直连 API Key，提示会相应变化：可为全部工具启用网关（直连 Key 仍保留在 .env 但运行时不用）、仅为未配置项启用，或完全跳过。

通过 hermes tools​

也可在交互式工具配置中逐项启用：

hermes tools

选择工具类别（Web、Browser、Image Generation、TTS），再将提供商选为 Nous Subscription。这会把该类别的选择键写为 nous（例如 image_gen.provider: nous）。

手动编辑配置​

每个工具类别只有一个选择键，选 Nous Subscription 即写入 nous：

web:
  backend: nous          # 网页搜索/抓取走 Tool Gateway

image_gen:
  provider: nous

tts:
  provider: nous

stt:
  provider: nous

browser:
  cloud_provider: nous

工作原理​

当某工具类别的选择键为 nous 时，运行时会把 API 调用路由到 Nous Tool Gateway，而不是使用直连 Key：

  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）。

优先级​

运行时始终使用已保存的选择，凭据是否存在不会影响路由：

  • 选择为 nous → 走网关，即使 .env 里仍有直连 Key（例如 FAL_KEY 会被忽略）
  • 选择为具体厂商（如 fal、firecrawl）→ 直连；若对应 Key 缺失则报错并提示运行 hermes tools，不会静默回退到网关
  • 从未配置过的类别 → 按可用凭据自动检测（行为不变）；但一旦存在选择，仅往 .env 加 Key 不会改变路由

（旧版的 use_gateway 布尔键已废弃：不再写入，读取时 use_gateway: true 等同于 nous。请改用 hermes tools 选择提供商。）

切回直连 Key​

对单个工具停用网关：

hermes tools    # 选择该工具 → 选直连提供商

或在配置中把选择键改回具体厂商：

web:
  backend: firecrawl  # 此时使用 .env 中的 FIRECRAWL_API_KEY

在 hermes tools 中选择非网关提供商时，选择键会被改写为该厂商名（旧的 use_gateway 键若存在会被一并移除），避免配置自相矛盾。

查看状态​

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” 的即经网关路由；带自有 Key 的会显示当前激活的提供商。

进阶：自建网关​

若使用自建或自定义网关，可在 ~/.hermes/.env 中用环境变量覆盖端点：

TOOL_GATEWAY_DOMAIN=nousresearch.com     # 网关路由基础域名
TOOL_GATEWAY_SCHEME=https                 # http 或 https（默认 https）
TOOL_GATEWAY_USER_TOKEN=your-token        # 鉴权 Token（通常由程序自动填充）
FIRECRAWL_GATEWAY_URL=https://...         # 单独覆盖 Firecrawl 端点

这些变量与订阅状态无关，始终可在配置中看到，便于自建基础设施。

常见问题​

需要删掉已有的 API Key 吗？​

不需要。类别选择为 Nous Subscription（nous）时，运行时会忽略该类别的直连 Key；Key 仍保留在 .env。之后在 hermes tools 里改回直连提供商，Key 即恢复生效。

能否部分工具走网关、部分走直连？​

可以。选择按工具类别独立配置。例如：网页与文生图选 Nous Subscription，TTS 用 ElevenLabs，浏览器用 Browserbase。

订阅到期会怎样？​

经网关路由的工具会停止工作，直到你 续订 或通过 hermes tools 改回直连 Key。

与「消息网关」（各聊天平台）是否冲突？​

不冲突。Tool Gateway 作用于工具运行时的 API 路由，与 CLI、Telegram、Discord 等入口无关。

Modal（无服务器终端后端）可作为 Nous 订阅的可选附加能力，但不会由 Tool Gateway 安装向导一并打开——请单独通过 hermes setup terminal 或在 config.yaml 中配置。