Nous 工具網關

開始使用

工具網關包含在付費的 Nous Portal 訂閱中。管理您的訂閱 →

工具網關（Tool Gateway）讓付費的 Nous Portal 訂閱者能夠通過現有訂閱使用網絡搜索、圖像生成、文本轉語音和瀏覽器自動化功能——無需從 Firecrawl、FAL、OpenAI 或 Browser Use 單獨註冊 API 密鑰。

包含內容

工具	功能說明	直接替代方案
網絡搜索與提取	通過 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 訂閱。您可以啟用任意組合——例如，使用網關進行網絡和圖像生成，同時保留自己的 ElevenLabs 密鑰用於 TTS。

資格說明

工具網關面向付費的 Nous Portal 訂閱者開放。免費層級賬戶無法訪問——請升級您的訂閱以解鎖該功能。

要檢查您的狀態：

hermes status

查找 Nous Tool Gateway 部分。它顯示哪些工具通過網關激活，哪些使用直接密鑰，以及哪些未配置。

啟用工具網關

在模型設置期間

當您運行 hermes model 並選擇 Nous Portal 作為提供商時，Hermes 會自動提示啟用工具網關：

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 密鑰，提示會有所調整——您可以為所有工具啟用網關（現有的密鑰會保留在 .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 工具網關，而不是使用直接 API 密鑰：

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

優先級

每個工具首先檢查 use_gateway：

• use_gateway: true → 通過網關路由，即使 .env 中存在直接 API 密鑰
• use_gateway: false（或缺失）→ 如果可用則使用直接 API 密鑰，僅在沒有直接密鑰時才回退到網關

這意味著您可以隨時在網關和直接密鑰之間切換，而無需刪除 .env 中的憑據。

切換回直接密鑰

要停止對特定工具使用網關：

hermes tools    # Select the tool → choose a direct provider

或在配置中設置 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”（通過 Nous 訂閱激活）的工具通過網關路由。擁有自己密鑰的工具會顯示哪個提供商處於活動狀態。

高級：自託管網關

對於自託管或自定義網關部署，您可以通過 ~/.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

無論訂閱狀態如何，這些環境變量在配置中始終可見——它們對於自定義基礎設施設置非常有用。

常見問題

我需要刪除現有的 API 密鑰嗎？

不需要。當設置 use_gateway: true 時，運行時會跳過直接 API 密鑰並通過網關路由。您的密鑰會原封不動地保留在 .env 中。如果您稍後禁用網關，它們將再次自動被使用。

我可以對一些工具使用網關，對其他工具使用直接密鑰嗎？

可以。use_gateway 標誌是針對每個工具的。您可以混合搭配——例如，對網絡和圖像生成使用網關，對自己的 TTS 使用 ElevenLabs 密鑰，對瀏覽器自動化使用 Browserbase。

如果我的訂閱過期了怎麼辦？

通過網關路由的工具將停止工作，直到您續訂訂閱或通過 hermes tools 切換到直接使用 API 密鑰。

網關是否與消息網關配合使用？

是的。無論您使用的是 CLI、Telegram、Discord 還是其他任何消息平臺，Tool Gateway 都會路由工具 API 調用。它在工具運行時級別運行，而不是在入口點級別。

是否包含 Modal？

Modal（無服務器終端後端）可作為 Nous 訂閱的可選附加組件提供。它不會通過 Tool Gateway 提示啟用——請通過 hermes setup terminal 或在 config.yaml 中單獨配置。