本指南帶你從頭到尾在 Nous Portal 訂閱上執行 Hermes Agent — 從註冊到驗證每個工具都正確路由。如果你只想了解 Portal 是什麼以及訂閱中包含什麼，請參見 Nous Portal 整合頁面。本頁是任務腳本。
前置需求
- Hermes Agent 已安裝（快速開始）
- 你設定的機器上有網頁瀏覽器（或 SSH 連接埠轉發 — 參見 OAuth over SSH）
- 大約 5 分鐘
你不需要：OpenAI 金鑰、Anthropic 金鑰、Firecrawl 帳戶、FAL 帳戶、Browser Use 帳戶或任何其他每供應商的憑證。這就是重點。
1. 取得訂閱
開啟 portal.nousresearch.com/manage-subscription，註冊並選擇一個方案。
已經訂閱了？跳到步驟 2。
2. 執行一次性設定
hermes setup --portal
這個單一指令做五件事：
- 開啟瀏覽器到 portal.nousresearch.com 進行 OAuth 登入
- 將重新整理代碼儲存在
~/.hermes/auth.json - 在
~/.hermes/config.yaml中設定model.provider: nous - 選擇預設的代理模型（
anthropic/claude-sonnet-4.6或類似） - 開啟 Tool Gateway 用於網路搜尋、圖片生成、TTS 和瀏覽器自動化
完成後，你會回到終端機準備聊天。
如果我 SSH 到伺服器呢？
OAuth 需要瀏覽器，但迴圈回呼在 Hermes 運行的機器上運行。兩個選項：
# 選項 A：SSH 連接埠轉發（建議）
ssh -N -L 8642:127.0.0.1:8642 user@remote-host # 在本機終端機
hermes setup --portal # 在遠端，在你的本機瀏覽器中開啟列印的 URL
# 選項 B：手動貼上（用於 Cloud Shell、Codespaces、EC2 Instance Connect）
hermes auth add nous --type oauth --manual-paste
# 然後重新執行 `hermes setup --portal` 以連線供應商 + 閘道
完整的逐步說明包括 ProxyJump 鏈、mosh/tmux 和 ControlMaster 陷阱，請參見 OAuth over SSH / 遠端主機。
3. 驗證是否成功
hermes portal info
你應該看到：
Nous Portal
───────────
Auth: ✓ logged in
Portal: https://portal.nousresearch.com
Model: ✓ using Nous as inference provider
Tool Gateway
────────────
Web search & extract via Nous Portal
Image generation via Nous Portal
Text-to-speech via Nous Portal
Browser automation via Nous Portal
如果任何行顯示「via Nous Portal」以外的內容，或認證行顯示「not logged in」，請跳到下方的疑難排解。
4. 執行你的第一次對話
hermes chat
嘗試一些同時鍛鍊模型和 Tool Gateway 的操作：
Hey, search the web for "Hermes Agent release notes" and summarize the top 3 hits.
你應該看到 Hermes 呼叫 web_search（由 Firecrawl 支援，透過閘道）並回傳摘要。如果搜尋運行且回應合理，你就完成了 — Portal 已端到端連線。
5. 選擇你真正想要的模型
hermes setup --portal 讓你在設定期間選擇模型，但訂閱的重點是存取完整目錄 — 在工作階段中途使用 /model 隨時切換：
/model anthropic/claude-sonnet-4.6 # 最佳通用代理
/model openai/gpt-5.4 # 強大的推理 + 工具呼叫
/model google/gemini-2.5-pro # 巨大的上下文視窗
/model deepseek/deepseek-v3.2 # 高性價比的編碼器
/model anthropic/claude-opus-4.6 # 用於困難問題的重型模型
或彈出選擇器瀏覽：
/model
永久選擇不同的預設：
# 在你的終端機中，在任何工作階段之外
hermes config set model.default anthropic/claude-sonnet-4.6
不要為代理工作選擇 Hermes-4
Hermes-4-70B 和 Hermes-4-405B 在 Portal 上以大幅折扣提供，但它們是聊天/推理模型，不是工具呼叫調優的。它們在多步驟代理迴圈中會很吃力。透過 Nous Chat 用於對話/研究工作，或透過訂閱代理從非代理工具使用。對於 Hermes Agent 本身，請堅持使用上述前沿代理模型。
Portal 自己的資訊頁面也有此警告 — 這是官方的 Nous 指導，而不僅是 Hermes 端的觀點。
6.（選擇性）自訂 Tool Gateway 路由
閘道是按工具選擇加入的，而非全有或全無。如果你已經有 Browserbase 帳戶並想繼續使用它，同時透過 Nous 路由網路搜尋和圖片生成，這是支援的：
hermes tools
# → Web search → "Nous Subscription" (recommended)
# → Image generation → "Nous Subscription" (recommended)
# → Browser → "Browserbase" (your existing key)
# → TTS → "Nous Subscription" (recommended)
這些行即使在你登入 Nous Portal 之前就出現在 hermes tools 中 — 如果你在沒有活動工作階段的情況下選擇「Nous Subscription」，Hermes 會在不更改你的推論供應商或其他工具的情況下內聯執行 Portal 登入。
使用以下指令驗證你的混合：
hermes portal tools
你會看到每個工具的路由 — 透過訂閱路由的工具顯示 via Nous Portal，使用你自己金鑰的工具顯示合作夥伴名稱（browserbase、firecrawl 等）。
7.（選擇性）啟用語音模式
因為 Tool Gateway 包含 OpenAI TTS，語音模式無需單獨的 OpenAI 金鑰即可運作：
hermes setup voice
# → 為 TTS 選擇 "Nous Subscription"
# → 選擇一個語音轉文字後端（本地 faster-whisper 是免費的，無需設定）
然後在任何訊息平台工作階段（Telegram、Discord、Signal 等）中，發送語音訊息，Hermes 會轉錄它、回應，並以合成語音回覆 — 全部在你的 Portal 訂閱上。
8.（選擇性）Cron + 永遠在線的工作流程
Portal 訂閱用於Cron 工作和批次處理的方式與互動式聊天相同 — OAuth 重新整理代碼被自動重用。無需額外設定；只需排程 Cron 工作，它們就會向你的訂閱計費。
hermes cron create "every day at 9am" \
"Search the web for top AI news and summarize the 5 most important stories" \
--name "Daily AI news"
Cron 工作在無人值守的情況下運行，透過你的 Portal 訂閱呼叫模型 + 網路搜尋 + 摘要化。
設定檔和多使用者設定
如果你使用 Hermes 設定檔（例如每個專案一個設定），Portal 重新整理代碼透過共用的代碼儲存自動在所有設定檔之間共享。在任何設定檔上登入一次，其餘的會自動獲取它。
對於多個人共享一台機器的團隊設定，每個人都有自己的 Portal 帳戶 → 每個主目錄有自己的 ~/.hermes/auth.json → 使用者之間不共享代碼。這是正確的邊界。
疑難排解
hermes portal info 在 hermes setup --portal 後顯示「not logged in」
OAuth 流程未完成。重新執行：
hermes portal
如果你的瀏覽器未開啟或回呼失敗，你可能在遠端/無頭主機上 — 請參見 OAuth over SSH 了解連接埠轉發和手動貼上的解決方法。
「Model: currently openrouter」（或其他供應商）而非「using Nous as inference provider」
你的本地設定漂移了。OAuth 成功但 model.provider 仍指向不同的供應商。修正：
hermes config set model.provider nous
或互動式：
hermes model
# 選擇 Nous Portal
使用 hermes portal info 重新驗證。
Tool Gateway 工具顯示合作夥伴名稱而非「via Nous Portal」
每個工具的設定覆蓋了閘道。執行：
hermes tools
# 為你想要閘道路由的每個工具選擇 "Nous Subscription"
某些使用者故意混合 — 例如透過路由網路搜尋但使用自己的 Browserbase 金鑰用於瀏覽器。如果是故意的，保留它。如果不是，此指令修正它。
工作階段中途出現「Re-authentication required」
你的 Portal 重新整理代碼被撤銷（密碼變更、手動撤銷、工作階段過期）。代碼現在在本機被隔離，因此 Hermes 不會無限重播它。只需再次登入：
hermes auth add nous
隔離會在成功重新登入後自動清除。
我想要的模型不在 /model 選擇器中
Portal 目錄鏡像 OpenRouter 的模型清單（300+）。如果模型缺失，嘗試直接輸入 OpenRouter 風格的 slug：
/model anthropic/claude-opus-4.6
/model openai/o1-2025-12-17
如果模型確實不可用，開啟 Issue — 大多數缺口是我們可以更新的路由設定。
帳單未出現在我的 Portal 帳戶上
hermes portal info 會告訴你是否真的透過 Portal 路由或透過其他供應商。常見原因：
model.provider設定為openrouter/anthropic/等 而非nous- OAuth 重新整理失敗導致退回不同的已設定供應商
- 多個 Hermes 設定檔中你使用了錯誤的那個（檢查
hermes profile current）
想要撤銷並重新開始
hermes auth remove nous # 清除本地重新整理代碼
# 然後重新執行設定或從 Portal Web UI 移除訂閱
這給你帶來什麼，用簡單數字
| 無 Portal | 有 Portal |
|---|---|
.env 中 1× OpenRouter / Anthropic / OpenAI 金鑰 | 1× OAuth 重新整理代碼，無 .env 金鑰 |
| 1× Firecrawl 金鑰用於網路 | 網路透過閘道路由 |
| 1× FAL 金鑰用於圖片生成 | 圖片生成透過閘道路由 |
| 1× Browser Use / Browserbase 金鑰用於瀏覽器 | 瀏覽器透過閘道路由 |
| 1× OpenAI 金鑰用於 TTS / 語音模式 | TTS 透過閘道路由 |
| 5 個獨立的儀表板、充值、發票 | 1 個訂閱、1 張發票 |
| 跨機器：複製所有 5 個金鑰 | 跨機器：重新 OAuth 一次 |
就是這樣。如果你本來就使用超過兩個這些後端，訂閱會自己回本。
另請參閱
- Nous Portal 整合頁面 — 訂閱內容概覽
- Tool Gateway — 每個閘道路由工具的完整詳情
- 訂閱代理 — 從非 Hermes 工具使用你的 Portal 訂閱
- 語音模式 — 在 Portal 訂閱上設定語音對話
- OAuth over SSH — 遠端 / 無頭登入模式
- 設定檔 — 在多個 Hermes 設定之間共享一個 Portal 登入