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 9B | fal-ai/flux-2/klein/9b | 快速,良好默认值 |
| FLUX 2 Pro | fal-ai/flux-2/pro | 更高保真度 FLUX |
| Z-Image Turbo | fal-ai/z-image/turbo | 风格化,快速 |
| Nano Banana Pro | fal-ai/gemini-3-pro-image | Google Gemini 3 Pro Image |
| GPT Image 1.5 | fal-ai/gpt-image-1/5 | OpenAI 图像生成,文本+图像 |
| GPT Image 2 | fal-ai/gpt-image-2 | OpenAI 最新版 |
| Ideogram V3 | fal-ai/ideogram/v3 | 强大的提示词遵循度+排版 |
| Recraft V4 Pro | fal-ai/recraft/v4/pro | 矢量风格,平面设计 |
| Qwen Image | fal-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,你的密钥再次成为来源。网关不是锁定。