跳到主要内容

Nous 工具网关

一次订阅。内置所有工具。

工具网包含于每个付费 Nous Portal 订阅中。它通过 Nous 已运行的基础设施来路由 Hermes 的工具调用——网页搜索、图像生成、文本转语音以及云浏览器自动化——因此您无需为了使其智能体变得有用而单独在 Firecrawl、FAL、OpenAI、Browser Use 或任何其他平台注册账户。

包含内容

工具您将获得
🔍网页搜索与提取通过 Firecrawl 实现的智能体级网页搜索和整页提取。无需担心速率限制——网关会处理扩缩容。
🎨图像生成一个端点下包含九个模型:FLUX 2 Klein 9BFLUX 2 ProZ-Image TurboNano Banana Pro(Gemini 3 Pro Image)、GPT Image 1.5GPT Image 2Ideogram V3Recraft V4 ProQwen Image。可通过标志按次选择,或让 Hermes 默认使用 FLUX 2 Klein。
🔊文本转语音OpenAI TTS 语音已集成到 text_to_speech 工具中。可将语音消息放入 Telegram,为流水线生成音频,为任何内容添加旁白。
🌐云浏览器自动化通过 Browser Use 提供的无头 Chromium 会话。browser_navigatebrowser_clickbrowser_typebrowser_vision——所有驱动智能体的基本操作,无需拥有 Browserbase 账户。

所有四项功能均按用量计费,计入您的 Nous 订阅。可任意组合使用——例如,将网关用于网页和图像,同时保留自己的 ElevenLabs 密钥用于 TTS,或将所有功能路由至 Nous。

为何推出此功能

构建一个能真正做事的智能体,意味着要拼接 5 个以上的 API 订阅——每个都有自己的注册、速率限制、计费方式和特殊之处。网关将其整合为一个账户:

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

您随时可以按工具、按需自行接入密钥。网关并非锁定,而是一条捷径。

快速上手

全新安装的最快路径:

hermes setup --portal # Nous OAuth,将 Nous 设为提供商,并一次性开启工具网关

已经配置过 Hermes?只需切换提供商:

hermes model # 选择 Nous Portal —— Hermes 会提议为您开启工具网关

当您选择 Nous Portal 时,Hermes 会提议开启工具网关。接受后即完成设置——所有支持的工具在下次运行时均将生效。

可随时检查哪些工具处于活动状态:

hermes portal status # Portal 认证 + 工具网关路由摘要
hermes portal tools # 网关目录,包含每个工具的当前路由
hermes status # 完整系统状态(工具网关是其中一个部分)

hermes portal status 会显示类似如下的部分:

◆ Nous 工具网关
Nous Portal ✓ 受管工具可用
网页工具 ✓ 通过 Nous 订阅激活
图像生成 ✓ 通过 Nous 订阅激活
TTS ✓ 通过 Nous 订阅激活
浏览器 ○ 通过 Browser Use 密钥激活

标记为"通过 Nous 订阅激活"的工具正在通过网关。其他任何工具则使用您自己的密钥。

适用条件

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

灵活搭配

网关可按工具分别启用。只为所需工具开启:

  • 所有工具通过 Nous —— 最简单;一次订阅,搞定。
  • 网关用于网页 + 图像,自行接入 TTS —— 保留您的 ElevenLabs 语音,其余交给我们。
  • 网关仅用于您没有密钥的功能 —— “我已经为 Browserbase 付费,但不想再注册 Firecrawl 账户” 这种情况完全可以。

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

hermes tools # 交互式选择器,用于每个工具类别

选择工具,将 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-image谷歌 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 → 图像生成 中显示当前实时列表。


配置参考

大多数用户无需触碰此部分——hermes modelhermes 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 将通过 Nous 路由,无论 .env 中是否有直接密钥。use_gateway: false(或省略)将优先使用直接密钥(如果可用),仅当没有直接密钥时才回退到网关。

禁用网关

web:
use_gateway: false # Hermes 现在将使用 .env 中的 FIRECRAWL_API_KEY

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

自托管网关(高级)

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

TOOL_GATEWAY_DOMAIN=your-domain.example.com
TOOL_GATEWAY_SCHEME=https
TOOL_GATEWAY_USER_TOKEN=your-token # 通常由 Portal 登录自动填充
FIRECRAWL_GATEWAY_URL=https://... # 特别覆盖单个端点

这些旋钮用于自定义基础设施设置(企业部署、开发环境)。普通订阅者无需设置它们。

常见问题

它是否兼容 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,您的密钥将重新成为数据源。网关并非锁定。