H繁中版
文件核心功能tool gateway
<!-- Source: https://hermesbible.com/docs/user-guide/features/tool-gateway -->

章節：核心功能 · 網址：https://hermesbible.com/docs/user-guide/features/tool-gateway

一個訂閱，內建所有工具。

Tool Gateway 包含在所有付費 Nous Portal 訂閱中。它負責路由 Hermes 的工具呼叫 — 網路搜尋、圖片生成、文字轉語音，以及雲端瀏覽器自動化 — 透過 Nous 已經運行的基礎架構來處理，所以你不需要另外註冊 Firecrawl、FAL、OpenAI、Browser Use 或其他服務，就能讓你的 agent 發揮作用。

包含內容

工具你可以獲得什麼
🔍網路搜尋與擷取透過 Firecrawl 提供 agent 等級的網路搜尋與整頁內容擷取。無需擔心速率限制 — Gateway 會自動處理擴展。
🎨圖片生成九個模型共用一個端點：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 的基礎操作，無需 Browseruse 帳號。

四項工具皆採用隨用隨付計費，從你的 Nous 訂閱額度中扣除。你可以自由搭配使用 — 用 Gateway 處理網路搜尋和圖片生成，同時保留自己的 ElevenLabs 金鑰做文字轉語音；或把所有工具都透過 Nous 處理。

為什麼需要它

要打造一個真正能做事的 agent，通常需要串接五個以上的 API 訂閱 — 每個都有自己的註冊流程、速率限制、計費方式和特殊設定。Gateway 把這些全部整合到一個帳號中：

  • 一張帳單。 只需付費給 Nous，其餘交給我們處理。
  • 一次註冊。 不用管理 Firecrawl、FAL、Browser Use 或 OpenAI 語音帳號。
  • 一把金鑰。 你的 Nous Portal OAuth 涵蓋所有工具。
  • 同等品質。 與直接使用金鑰連接相同的後端 — 只是透過我們轉接。

隨時可以帶入自己的金鑰 — 隨時為單一工具切換。Gateway 不是綁定機制，而是快捷通道。

開始使用

有三種方式可以開始 — 選擇最適合你目前情況的方式：

hermes setup --portal     # 全新安裝：一次完成 Nous OAuth + 設定 Nous 為 provider + 啟用 Tool Gateway

hermes model              # 將推論供應商切換為 Nous Portal — Hermes 接著會詢問是否為所有工具啟用 Gateway

hermes tools              # 逐個工具啟用 Gateway — 為你想用的工具選擇「Nous Subscription」

hermes setup --portal 和 hermes model 是一次性設定的路徑：登入一次，選擇性地將所有工具切換到 Gateway。hermes tools 是自由搭配的路徑 — 只啟用你需要的工具，一次一個。

你不必先登入。 使用 hermes tools 時，Nous 管理的後端（Web search、Image、Video、TTS、Browser）始終會列出，即使你從未登入過 Nous Portal。選擇其中一個，如果你尚未驗證身份，Hermes 會在現場執行 Portal 登入流程 — 不需要先執行 hermes model。如果你的Nous OAuth 已經啟用，選擇後端會立即啟用，不會再顯示額外提示。這個路徑只會登入並啟用你選定的那個工具 — 不會切換你的推論供應商，也不會提示你為其他所有工具啟用 Gateway。

隨時查看目前啟用的狀態：

hermes portal info        # Portal 驗證摘要 + Tool Gateway 路由摘要
hermes portal tools       # Gateway 目錄及各工具目前的路由設定
hermes status             # 完整系統狀態（Tool Gateway 是其中一個區段）

hermes portal info 會顯示如下內容：

◆ 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」的工具正透過 Gateway 運作。其他工具則使用你自己的金鑰。

使用資格

Tool Gateway 是付費訂閱功能。免費層級的 Nous 帳號可以使用 Portal 進行推論，但不包含 managed tools — 請升級你的方案以啟用 Gateway。

部分帳號還享有免費工具配額 — 一小段 managed tool 額度，無需付費訂閱即可使用 Gateway 工具呼叫。當免費配額可用時，Gateway 會在首次使用時顯示設定提示，讓你可以立即開始使用 managed tools。

自由搭配

Gateway 是按工具獨立設定的。只啟用你需要的功能：

  • 所有工具都透過 Nous — 最簡單；一個訂閱就搞定。
  • Web 和圖片用 Gateway，TTS 帶自己的金鑰 — 保留你的 ElevenLabs 語音，其餘交給 Nous 處理。
  • 只為你沒有金鑰的工具啟用 Gateway — 「我已經付費使用 Browserbase，但不想再開一個 Firecrawl 帳號」這樣完全可以。

隨時透過以下方式切換任何工具：

hermes tools          # 各工具類別的互動式選擇器

選擇工具，將 provider 設為 Nous Subscription（或你偏好的直接連接供應商）。無需手動編輯設定檔。如果你尚未登入 Nous Portal，選擇 Nous Subscription 會直接在流程中啟動 Portal 登入 — 不需要先透過 hermes model 進行驗證。

使用個別圖片模型

圖片生成預設使用 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/nano-banana-proGoogle 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強大的 prompt 遵循度 + 排版
Recraft V4 Profal-ai/recraft/v4/pro/text-to-image向量風格，平面設計
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 會一律透過 Nous 路由，無論 .env 中是否設定了自己的金鑰。use_gateway: false（或未設定）則會優先使用 .env 中的直接金鑰，僅在沒有設定時才退回使用 Gateway。

停用 Gateway

web:
  use_gateway: false   # Hermes 現在會使用 .env 中的 FIRECRAWL_API_KEY

使用 hermes tools 選擇非 Gateway 的 provider 時，它會自動清除此參數，所以通常不需要手動設定。

自架 Gateway（進階）

要運行自己的 Nous 相容 Gateway？在 ~/.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 / 其他訊息閘道一起使用嗎？

可以。Tool Gateway 運作在工具執行層級，而非 CLI 層級。所有能呼叫工具的介面 — CLI、Telegram、Discord、Slack、IRC、Teams、API 伺服器，以及其他任何介面 — 都能透明地使用它。

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

透過 Gateway 路由的工具會停止運作，直到你續約或透過 hermes tools 換回直接 API 金鑰。Hermes 會顯示明確的錯誤訊息，指引你前往 Portal。

我能查看各工具的使用量或費用嗎？

可以 — Nous Portal 儀表板會按工具分列使用量，讓你了解是哪些工具產生了費用。

Modal（無伺服器終端機）包含在內嗎？

Modal 是透過 Nous 訂閱提供的選購附加服務，不屬於預設的 Tool Gateway 方案。如需遠端沙箱來執行 shell 指令，可透過 hermes setup terminal 或直接在 config.yaml 中設定。

啟用 Gateway 後需要刪除現有的 API 金鑰嗎？

不需要 — 把它們保留在 .env 中即可。當 use_gateway: true 時，Hermes 會跳過直接金鑰而使用 Gateway。把參數改回 false，你的金鑰就會重新生效。Gateway 不是綁定機制。

Tool Search

subscription proxytool search