Skip to main content
將 CometAPI 作為 Hermes Agent 的模型提供者。本指南支援 Hermes 的兩種 CometAPI 連接方式：適用於大多數文字模型的一般 OpenAI 相容端點，以及透過 Anthropic 訊息使用 Claude 的路由。

​
先決條件

  • Git
  • 具有有效 API key 的 CometAPI 帳戶
  • macOS、Linux 或 WSL2 上的終端機

​
安裝

1

取得你的 CometAPI API key

登入 CometAPI 主控台。按一下 Add API Key，並複製你的 CometAPI API key。
顯示 Add API Key 按鈕的 CometAPI 儀表板
顯示 base URL 的 CometAPI API key 詳細資訊
2

安裝 Hermes Agent

以下指令會執行官方安裝程式：
如果目前的 shell 還無法識別 hermes 指令，請重新載入 shell 設定：
Hermes 會將設定儲存在 ~/.hermes/，將 hermes 指令連結到 ~/.local/bin，並且可能會將 ~/.local/bin 加入你的 shell PATH。

​
設定

選擇與模型家族相符的 CometAPI 路由：
不要將 Hermes 設定為使用 https://api.cometapi.com/v1beta 的自訂 Gemini 原生 provider。Gemini 模型請使用與 OpenAI 相容的 Hermes 設定。若要直接呼叫 Gemini API，請使用 Gemini generateContent API。
1

儲存你的 CometAPI 金鑰

開啟 ~/.hermes/.env 並加入以下值：
COMETAPI_KEY 由具名 Claude provider 使用。OPENAI_API_KEY 可讓 Hermes 的自訂 OpenAI 相容端點備援機制持續運作。
2

設定與 OpenAI 相容的路由

這個路由適用於大多數 CometAPI 文字模型，包括從 Hermes 使用的 Gemini 模型。開啟 ~/.hermes/config.yaml，並確認 model 區段如下：
將 your-model-id 替換為 CometAPI Models 頁面 上目前可用的文字 model ID。
請將 API 金鑰保存在 ~/.hermes/.env。不要在 config.yaml 中硬編碼密鑰。
此設定會配置主要聊天模型。Hermes 也可以針對視覺或網頁擷取等任務使用獨立的輔助模型。
3

設定 Claude Messages 路由

當你希望 Hermes 透過 Anthropic Messages 呼叫 Claude 模型時，請使用這個路由。開啟 ~/.hermes/config.yaml，並使用具名 provider：
將 your-claude-model-id 替換為 CometAPI Models 頁面 上目前可用的 Claude model ID。
此路由的 base_url 請保持為 https://api.cometapi.com。Hermes 會透過具名 provider 使用 Anthropic Messages transport。

​
驗證

1

檢查設定

以下指令可確認 Hermes 能夠讀取設定與 API 金鑰：
如果 hermes config check 在更新後回報缺少選項，請執行 hermes config migrate，然後再檢查一次。
2

執行實際聊天測試

以下指令會透過 CometAPI 傳送一個真實請求：
設定成功時會回傳 CONNECTED，且不會出現 auth 或 endpoint 錯誤。當 Claude Messages 設定啟用時，這也會確認 Hermes 能透過 CometAPI 使用 anthropic_messages transport。

​
選用設定

如果你要取代較舊版本的 Hermes 安裝，請先使用內建解除安裝程式：
在解除安裝程式中，選擇 Full uninstall 以移除 CLI、PATH 項目，以及 ~/.hermes/ 資料。接著重新執行安裝步驟，並使用相同的 CometAPI 設定繼續。
如果你偏好 OpenAI 相容路徑的互動式流程，請執行 hermes model 並選擇 Custom endpoint。接著輸入以下值：
  • Base URL: https://api.cometapi.com/v1
  • API key: 你的 CometAPI API key
  • Model: 目前可用的 CometAPI 文字 model ID
此流程會將 OpenAI 相容提供者設定寫入 config.yaml。若是 Claude Messages，請直接編輯 config.yaml，以便具名提供者保留 transport: anthropic_messages。