跳到主要内容

Nous 工具网关

一个订阅,全部内置工具。

工具网关(Tool Gateway)包含在每个付费 Nous Portal 订阅中。它将 Hermes 的工具调用——网页搜索、图像生成、文本转语音和云端浏览器自动化——通过 Nous 已在运行的基础设施路由,让你无需为了让 Agent 真正有用而分别注册 Firecrawl、FAL、OpenAI、Browser Use 或其他任何服务。

包含内容​

工具你能获得什么
🔍网页搜索与提取通过 Firecrawl 提供 Agent 级别的网页搜索和整页提取。无需担心速率限制——网关处理弹性伸缩。
🎨图像生成单一端点支持九种模型:FLUX 2 Klein 9B、FLUX 2 Pro、Z-Image Turbo、Nano Banana Pro(Gemini 3 Pro Image)、GPT Image 1.5、GPT Image 2、Ideogram V3、Recraft V4 Pro、Qwen Image。每次生成时通过标志选择,或让 Hermes 默认使用 FLUX 2 Klein。
🔊文本转语音OpenAI TTS 语音连接到 text_to_speech 工具。向 Telegram 投递语音笔记、为流水线生成音频、为任何内容配音。
🌐云端浏览器自动化通过 Browser Use 提供无头 Chromium 会话。browser_navigate、browser_click、browser_type、browser_vision——所有 Agent 驱动原语,无需 Browserbase 账户。

四种功能均按使用量计费,计入你的 Nous 订阅。可任意组合——将网关用于网络和图像,同时保留自己的 ElevenLabs 密钥用于 TTS,或通过 Nous 路由一切。

为何如此设计​

构建一个真正能做事的 Agent 意味着需要拼凑 5+ 个 API 订阅——每个都有自己的注册、速率限制、计费和使用方式。网关将这一切折叠成一个账户:

  • 一张账单。 付给 Nous;其余的我们来处理。
  • 一次注册。 无需 Firecrawl、FAL、Browser Use 或 OpenAI 音频账户。
  • 一个密钥。 你的 Nous Portal OAuth 覆盖每个工具。
  • 同等质量。 与直接使用密钥路由相同的后端——只是由我们来代理。

随时自带密钥——按工具、随时都可以。网关不是锁定,而是捷径。

开始使用​

hermes model # Pick Nous Portal as your provider

选择 Nous Portal 后,Hermes 会提议开启工具网关。接受后即完成——每个支持的工具在下次运行时都会生效。

随时检查当前状态:

hermes status

你会看到类似这样的部分:

◆ 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

标记为"active via Nous subscription"的工具通过网关路由。其他工具使用你自己的密钥。

资格要求​

工具网关是付费订阅功能。免费层 Nous 账户可以使用 Portal 进行推理,但不包含托管工具——升级你的套餐以解锁网关。

混合搭配​

网关是按工具设置的。只为你需要的部分开启:

  • 所有工具通过 Nous — 最简单;一个订阅,搞定。
  • 网关用于网络+图像,自带 TTS — 保留你的 ElevenLabs 语音,让 Nous 处理其余。
  • 网关仅用于没有密钥的功能 — "我已经付了 Browserbase,但不想要 Firecrawl 账户",完全可以。

通过以下命令随时切换任意工具:

hermes tools # Interactive picker for each tool category

选择工具,选择 Nous Subscription 作为提供商(或你偏好的任意直接提供商)。无需编辑配置文件。

使用各图像模型​

图像生成默认使用 FLUX 2 Klein 9B(速度快)。通过向 image_generate 工具传入模型 ID 来按次覆盖:

模型ID最适合
FLUX 2 Klein 9Bfal-ai/flux-2/klein/9b快速,良好默认值
FLUX 2 Profal-ai/flux-2/pro更高保真度 FLUX
Z-Image Turbofal-ai/z-image/turbo风格化,快速
Nano Banana Profal-ai/gemini-3-pro-imageGoogle Gemini 3 Pro Image
GPT Image 1.5fal-ai/gpt-image-1/5OpenAI 图像生成,文本+图像
GPT Image 2fal-ai/gpt-image-2OpenAI 最新版
Ideogram V3fal-ai/ideogram/v3强大的提示词遵循度+排版
Recraft V4 Profal-ai/recraft/v4/pro矢量风格,平面设计
Qwen Imagefal-ai/qwen-image阿里巴巴多模态

列表会持续更新——hermes tools → Image Generation 显示当前实时列表。


配置参考​

大多数用户不需要手动配置——hermes model 和 hermes tools 以交互方式涵盖每个工作流。本节适用于直接编写 config.yaml 或脚本化设置。

每工具 use_gateway 标志​

每个工具的配置块接受 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 无论 .env 中是否有直接密钥,都通过 Nous 路由。use_gateway: false(或缺失)使用直接密钥(如果有),仅在没有直接密钥时回退到网关。

禁用网关​

web:
use_gateway: false # Hermes now uses FIRECRAWL_API_KEY from .env

当你通过 hermes tools 选择非网关提供商时,该标志会自动清除,因此通常由工具自动处理。

自托管网关(高级)​

运行自己的 Nous 兼容网关?在 ~/.hermes/.env 中覆盖端点:

TOOL_GATEWAY_DOMAIN=your-domain.example.com
TOOL_GATEWAY_SCHEME=https
TOOL_GATEWAY_USER_TOKEN=your-token # normally auto-populated from Portal login
FIRECRAWL_GATEWAY_URL=https://... # override one endpoint specifically

这些配置项适用于自定义基础设施(企业部署、开发环境)。普通订阅者永远不需要设置它们。

常见问题​

它能与 Telegram / Discord / 其他消息网关配合使用吗?​

可以。工具网关在工具执行层运行,而非 CLI 层。每个能调用工具的界面——CLI、Telegram、Discord、Slack、IRC、Teams、API 服务器、任何其他界面——都能透明地受益于它。

如果我的订阅过期会怎样?​

通过网关路由的工具将停止工作,直到你续订或通过 hermes tools 换入直接 API 密钥。Hermes 会显示清晰的错误信息,指向 Portal。

我可以查看每个工具的使用量或费用吗?​

可以——Nous Portal 仪表板按工具分解使用量,让你了解账单的来源。

Modal(无服务器终端)是否包含在内?​

Modal 作为 Nous 订阅的可选附加项提供,不是默认工具网关包的一部分。当你需要用于 shell 执行的远程沙箱时,通过 hermes setup terminal 或直接在 config.yaml 中配置。

启用网关时需要删除现有的 API 密钥吗?​

不需要——保留 .env 中的密钥。当 use_gateway: true 时,Hermes 跳过直接密钥并使用网关。将标志翻回 false,你的密钥再次成为来源。网关不是锁定。