<!-- Source: https://hermesbible.com/docs/integrations/nous-portal -->

Nous Portal 是 Nous Research 的統一訂閱閘道，也是執行 Hermes Agent 的建議方式。一個 OAuth 登入取代了在每個模型實驗室、搜尋 API、圖片生成器和瀏覽器供應商之間切換不同帳號、API 金鑰和帳單關係的繁瑣操作。

如果你只有一時間設定一個東西，就設定這個。最快路徑：

hermes setup --portal

這個單一指令會執行 Portal OAuth、讓你選擇 Nous 模型、在 config.yaml 中將 Nous 設為你的推理供應商，並啟用 Tool Gateway。執行後你就可以立即開始 hermes chat。

還沒有訂閱？前往 portal.nousresearch.com/manage-subscription——註冊後回來執行上面的指令。

訂閱包含什麼

300 多個頂級模型，一張帳單

Portal 代理來自整個生態系的精選 agentic 模型目錄——針對你的 Nous 訂閱計費，而不是每個實驗室一個信用額度。

路由在底層透過 OpenRouter 進行，所以模型可用性和容錯行為與你使用 OpenRouter 金鑰時相同——只是針對你的 Nous 訂閱計費。在工作階段中使用 /model 在 Claude Sonnet 4.6（用於程式碼）和 Gemini 3 Pro（用於長上下文）之間切換——無需新憑證、無需充值、不會有意外的零餘額錯誤。

Nous Tool Gateway

相同的訂閱解鎖了 Tool Gateway，它將 Hermes Agent 的工具呼叫路由透過 Nous 管理的基礎設施。五個後端，一次登入：

沒有閘道的話，接上每一個都意味著一個 Firecrawl 帳號、一個 FAL 帳號、一個 Browser Use 帳號、一個 OpenAI 金鑰和一個 Modal 帳號——五個獨立的註冊、五個獨立的儀表板、五個獨立的充值流程。有了閘道，所有這些都透過一個訂閱路由。

你也可以只啟用特定的閘道工具（例如網路搜尋但不啟用圖片生成）——參閱下方的將閘道與你自己的後端混合。

Nous Chat

你的 Portal 帳號也涵蓋了 chat.nousresearch.com——Nous Research 的網頁聊天介面，使用相同的模型目錄。當你不在終端機旁時很有用，或用於非代理的對話工作。

dotfiles 中無憑證

因為所有內容都透過一個 OAuth 驗證的 Portal 會話路由，你不會在 .env 檔案中累積十幾個長效 API 金鑰。~/.hermes/auth.json 中的重新整理 token 是磁碟上唯一的憑證，Hermes 為每個請求從它鑄造短期 JWT——參閱下方的Token 處理。

跨平台一致性

原生 Windows 的每個工具 API 金鑰設定是其痛點——從 Windows 安裝 Firecrawl 帳號、FAL 帳號、Browser Use 帳號、OpenAI 金鑰是建立有用代理時摩擦最高的部分。Portal 訂閱解決了這個問題：一個 OAuth 涵蓋模型和每個閘道工具，所以 Windows 使用者獲得與 macOS/Linux 相同的體驗，無需手動配置四個後端。

關於 Hermes 4

Nous Research 自己的 Hermes 4 系列（Hermes-4-70B、Hermes-4-405B）可透過 Portal 以大幅折扣的費率使用。這些是頂級混合推理聊天模型——在數學、科學、指令遵循、結構遵循、角色扮演和長文寫作方面表現出色。

然而，它們不建議在 Hermes Agent 內部使用。Hermes 4 是為聊天和推理調優的，而不是代理依賴的快速工具呼叫循環。將它們用於 Nous Chat、研究工作流程，或透過訂閱代理從其他工具使用——但對於代理工作，請從目錄中選擇一個頂級 agentic 模型：

/model anthropic/claude-sonnet-4.6     # 最佳通用 agentic 模型
/model openai/gpt-5.5-pro              # 強推理 + 工具呼叫
/model google/gemini-3-pro-preview     # 巨大上下文視窗
/model deepseek/deepseek-v4-pro        # 高性價比程式碼助手

Portal 自己的模型資訊頁面也有相同的警告，所以這不是 Hermes 端的觀點——這是 Nous Research 的官方指導。

設定

全新安裝——一個指令

hermes setup --portal

這會一次性完成完整設定：

1. 開啟你的瀏覽器到 portal.nousresearch.com 進行 OAuth 登入
2. 將重新整理 token 儲存在 ~/.hermes/auth.json
3. 讓你從精選清單中選擇一個 Nous 模型（或跳過以保留你目前的模型）
4. 在 ~/.hermes/config.yaml 中將 Nous 設為你的推理供應商（當你選擇模型時）
5. 啟用 Tool Gateway（網路、圖片、TTS、瀏覽器路由）
6. 回到你的終端機，準備好執行 hermes chat

如果你還沒有訂閱，請先在 portal.nousresearch.com/manage-subscription 註冊。

已有安裝——在其他供應商旁邊新增 Portal

如果你已經配置了 OpenRouter、Anthropic 或任何其他供應商，並想在它們旁邊新增 Portal：

hermes model
# 從供應商清單中選擇「Nous Portal」
# 瀏覽器開啟，登入，完成

你現有的供應商保持配置。你可以在工作階段中使用 /model 或在工作階段之間使用 hermes model 在它們之間切換——Portal 成為你的可用供應商之一，而不是唯一的一個。

無頭 / SSH / 遠端設定

OAuth 需要瀏覽器，但迴圈回呼在 Hermes 運行的機器上執行。對於遠端主機，請參閱 OAuth over SSH / 遠端主機——相同的模式對 Portal 和任何其他基於 OAuth 的供應商都適用（ssh -L 埠轉發、--manual-paste 用於僅瀏覽器的環境如 Cloud Shell / Codespaces）。

配置檔設定

如果你使用 Hermes 配置檔，Portal 重新整理 token 會透過共享的 token 儲存自動在所有配置檔之間共享。在任何配置檔上登入一次，其他配置檔會自動取得——無需為每個配置檔重複 OAuth 流程。

日常使用 Portal

檢查已接上了什麼

hermes portal            # 登入 Nous Portal + 設定它（一次性引導）
hermes portal info       # 登入狀態、訂閱資訊、模型 + 閘道路由
hermes portal status     # `portal info` 的別名
hermes portal tools      # 詳細的 Tool Gateway 目錄及每個工具的路由
hermes portal open       # 在你的瀏覽器中開啟訂閱管理頁面

hermes portal（不帶子指令）是 hermes auth add nous --type oauth 的人類可讀別名——它為你登入、讓你選擇 Nous 模型、將 Nous 設為你的推理供應商，並提供 Tool Gateway 加入選項（與 hermes setup --portal 相同，與首次快速設定的 Nous 流程相同）。

hermes portal info 為你提供高層次的概覽：

  Nous Portal
  ───────────
  Auth:    ✓ 已登入
  Portal:  https://portal.nousresearch.com
  Model:   ✓ 使用 Nous 作為推理供應商

  Tool Gateway
  ────────────
  網路搜尋與擷取  透過 Nous Portal
  圖片生成        透過 Nous Portal
  文字轉語音      透過 Nous Portal
  瀏覽器自動化    透過 Nous Portal
  雲端終端機      未設定

切換模型

在工作階段中：

/model anthropic/claude-sonnet-4.6
/model openai/gpt-5.5-pro
/model google/gemini-3-pro-preview

或開啟選擇器：

/model
# 方向鍵，Enter 選擇

在工作階段外（完整的設定精靈，在新增新供應商時很有用）：

hermes model

將閘道與你自己的後端混合

如果你已經有例如 Browserbase 帳號，並想在透過 Nous 路由網路搜尋和圖片生成的同時繼續使用它，這是支援的。使用 hermes tools 為每個工具選擇後端：

hermes tools
# → 網路搜尋       →「Nous Subscription」
# → 圖片生成       →「Nous Subscription」
# → 瀏覽器         →「Browserbase」（你現有的金鑰）
# → TTS            →「Nous Subscription」

Tool Gateway 是逐個工具加入的，不是全有或全無。託管後端無論你是否登入 Nous Portal 都會出現在 hermes tools 中——如果你在驗證之前選擇「Nous Subscription」，Hermes 會在行內執行 Portal 登入（它不會改變你的推理供應商或接觸你的其他工具）。參閱 Tool Gateway 文件了解完整的逐工具配置矩陣。

訂閱管理

隨時管理你的方案、查看使用量或升級/取消：

• 網頁：portal.nousresearch.com/manage-subscription
• CLI 快捷方式：hermes portal open（在你的預設瀏覽器中開啟相同頁面）

設定參考

執行 hermes setup --portal 後，~/.hermes/config.yaml 會如下：

model:
  provider: nous
  default: anthropic/claude-sonnet-4.6     # 或你選擇的任何模型
  base_url: https://inference-api.nousresearch.com/v1

Tool Gateway 設定位於各自的工具區段下：

web:
  backend: nous       # 網路搜尋/擷取透過 Tool Gateway 路由

image_gen:
  provider: nous

tts:
  provider: nous

browser:
  backend: nous

OAuth 重新整理 token 單獨儲存在 ~/.hermes/auth.json 中（不在 config.yaml 中——憑證和設定在設計上是分開的）。

Token 處理

Hermes 在每次推理呼叫時從你儲存的 Portal 重新整理 token 鑄造一個短期 JWT，而不是重用長效 API 金鑰。token 生命週期是完全自動的——刷新、鑄造、暫時性 401 重試——你永遠看不到它。

如果 Portal 使重新整理 token 失效（密碼變更、手動撤銷、會話過期），失效的重新整理 token 會被本地隔離，所以 Hermes 停止重放它，你不會看到一連串相同的 401 錯誤。下一次呼叫會顯示清晰的「需要重新驗證」訊息。執行 hermes auth add nous 重新登入；隔離會在下次成功登入後清除。

疑難排解

hermes portal info 顯示「未登入」

你尚未完成 OAuth 流程，或你的重新整理 token 被清除了。執行：

hermes portal

或使用 hermes model 重新選擇 Nous Portal。

在工作階段中收到「需要重新驗證」訊息

你的 Portal 重新整理 token 被使失效了（密碼變更、手動撤銷或會話過期）。執行 hermes auth add nous，你的下一個請求將使用新的憑證。任何對舊 token 的隔離會在成功重新登入後自動清除。

想使用 Portal 未暴露的特定供應商模型

Portal 透過 OpenRouter 代理，所以 OpenRouter 支援的任何模型通常都可用。如果特定模型未出現在 /model 中，嘗試直接使用 OpenRouter 風格的代碼：

/model anthropic/claude-opus-4.6

如果模型確實缺失，開一個 issue——我們會將 Portal 的目錄暴露給 Hermes，缺口通常意味著我們可以更新的路由設定。

帳單未出現在我的 Portal 帳號上

先檢查 hermes portal info——如果它顯示你使用的是不同的供應商（Model: currently openrouter 而不是 using Nous as inference provider），你的本地設定已經漂移。執行 hermes model，選擇 Nous Portal，下一個請求就會透過你的訂閱路由。

另請參閱

• Tool Gateway — 每個閘道工具的完整詳情、逐工具配置和定價
• 訂閱代理 — 從非 Hermes 工具（其他代理、腳本、第三方客戶端）使用你的 Portal 訂閱
• 語音模式 — 使用 Portal 的 OpenAI TTS 進行語音對話
• AI 供應商 — 完整供應商目錄，如果你想比較替代方案
• OAuth over SSH — 從遠端主機或僅瀏覽器環境登入
• 配置檔 — 多個 Hermes 配置共享一個 Portal 登入

---

---

提示與最佳實踐