Nous 工具网关
Tool Gateway 已包含在付费 Nous Portal 订阅中。管理你的订阅 →
Tool Gateway 允许付费 Nous Portal 订阅者通过现有订阅直接使用网页搜索、图像生成、文本转语音和浏览器自动化，无需再为 Firecrawl、FAL、OpenAI 或 Browser Use 分别申请 API key。
包含内容
| 工具 | 功能 | 直接替代方案 |
|---|---|---|
| Web search & extract | 通过 Firecrawl 进行网页搜索与页面提取 | FIRECRAWL_API_KEY, EXA_API_KEY, PARALLEL_API_KEY, TAVILY_API_KEY |
| Image generation | 通过 FAL 生成图像（8 个模型：FLUX 2 Klein/Pro、GPT-Image、Nano Banana Pro、Ideogram、Recraft V4 Pro、Qwen、Z-Image） | FAL_KEY |
| Text-to-speech | 通过 OpenAI TTS 进行文本转语音 | VOICE_TOOLS_OPENAI_KEY, ELEVENLABS_API_KEY |
| Browser automation | 通过 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 作为大模型提供商（provider）时，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 即可。
如果你已经给部分工具配置了直接 API key，提示内容也会相应调整。你可以选择为全部工具启用网关、只为尚未配置的工具启用，或者完全跳过。已有 key 会继续保存在 .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 key：
- 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 key，也优先走网关use_gateway: false（或未设置）→ 若存在直接 API key，就使用直接 key；只有在没有直接 key 时才回落到网关
这意味着你可以随时在网关和直接 key 之间切换，而不需要删除 .env 中已有的凭据。
切回直接 key
如果你想让某个工具不再走网关：
hermes tools # 选择对应工具 → 改成直接提供方
或者直接在配置中将 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” 的工具表示当前正通过网关运行；有独立 key 的工具则会显示正在使用的具体提供方。
进阶：自托管网关
如果你使用自托管或自定义网关部署，也可以通过 ~/.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
这些环境变量始终会出现在配置体系中，不受订阅状态限制，因此也适用于你自己的基础设施部署。
FAQ
需要删除已有 API key 吗？
不需要。只要设置了 use_gateway: true，运行时就会跳过直接 key 并通过网关路由；你的 key 仍会原样保留在 .env 中。之后如果关闭网关，它们会立即重新生效。
可以部分工具走网关、部分工具走直接 key 吗？
可以。use_gateway 是按工具维度生效的。你可以自由混用，例如网页和图像生成走网关，TTS 使用自己的 ElevenLabs key，浏览器自动化则继续用 Browserbase。
如果订阅过期会怎样？
原本通过网关路由的工具将无法继续使用，直到你 续费订阅，或者通过 hermes tools 切换回直接 API key。
它能和消息网关一起工作吗？
可以。Tool Gateway 工作在工具运行时层面，不取决于入口是 CLI、Telegram、Discord 还是其他消息平台。
Modal 包含在其中吗？
Modal（Serverless 终端后端）可作为 Nous 订阅的可选增值项使用。它不会在 Tool Gateway 启用流程中自动开启，需要你单独通过 hermes setup terminal 或 config.yaml 配置。