跳到主要內容

使用 Nous Portal 運行 Hermes Agent

本教程帶你從零跑通 Nous Portal。如果你只想少配 Key、儘快使用 Hermes，這是官方推薦路線。

準備工作​

你需要：

  • 已安裝 Hermes Agent；
  • 當前機器能打開瀏覽器，或能做 SSH 端口轉發；
  • 大約 5 分鐘。

你不需要單獨準備 OpenAI、Anthropic、Firecrawl、FAL、Browser Use 等一堆賬號。這正是 Portal 的意義。

第一步：運行 setup​

運行：

hermes setup --portal

Hermes 會引導你完成 OAuth 登錄，並把 Nous Portal 寫入配置。登錄成功後，先檢查狀態：

hermes portal status

如果狀態顯示 provider 和 Tool Gateway 已連接，就可以進入下一步。

第二步：開始對話​

運行：

hermes chat

可以先問一個需要工具能力的問題，例如：

請搜索 Hermes Agent 最新 release，並總結升級建議。

如果 Hermes 能調用網頁搜索或提取工具，說明 Portal 和 Tool Gateway 基本跑通。

第三步：切換模型​

Portal 提供多個模型。你可以在 Dashboard 中選擇，也可以通過 Hermes 的模型配置界面切換。配置模型時建議遵循這個原則：

  • 主模型選擇強推理、強工具調用模型；
  • 輔助模型選擇快且便宜的模型；
  • 視覺、網頁摘要等任務按能力單獨配置。

更多說明見 配置模型。

遠程服務器怎麼辦？​

如果 Hermes 跑在遠程服務器上，而 OAuth 需要本地瀏覽器，可以用 SSH 端口轉發。簡單來說，就是把遠程回調端口映射到本地，讓瀏覽器能完成登錄回跳。

官方提供了獨立的 OAuth over SSH 指南，本中文站後續會繼續補齊該頁面。

排錯建議​

如果 setup 後不能正常使用，按順序檢查：

  1. hermes portal status 是否顯示登錄成功；
  2. 當前 profile 是否使用 Portal provider；
  3. Dashboard 和 CLI 是否使用同一個 Hermes home；
  4. 是否有舊環境變量覆蓋了 provider；
  5. 網絡環境是否阻止 OAuth 回調或 Portal API。

不要一上來同時改很多配置。一次只改一個變量，更容易定位問題。

參考鏈接​