我應該在 Hermes Agent 中選擇哪個提供者？

Hermes模型中選擇Tencent TokenHub。其記錄的提供者 ID 為 tencent-tokenhub，別名為 tokenhub。

TokenHub API 金鑰該放在哪裡？

將 TOKENHUB_API_KEY=... 儲存在 ~/.hermes/.env 中，這是該提供者的憑證文件 Hermes Agent 文件。

為什麼我不應該對本指南中的模型進行硬編碼？

騰訊 TokenHub 目錄已上線，可用型號可能會變更。選擇 Hermes 型號顯示的型號或輸入準確的目前可用 ID。

Hermes Agent 和 Nous Research 有什麼關係？

Hermes Agent 是 Nous Research 的一個開源代理專案。本公司融資或估值搜尋不在本整合指南範圍內。

我應該如何比較 Hermes Agent 和 OpenClaw？

使用相同的真實任務來比較部署、記憶體、技能、通路整合、工具可靠性、模型成本和維護複雜性。

Hermes 代理安裝和 TokenHub 提供者設定 |代幣中心

Hermes Agent 可以透過 TokenHub 的 OpenAI compatible 相容 API 中轉模型請求。本文保留官方安裝方式，並只替換 API key、Base URL 和模型 ID。

本指南使用的 TokenHub endpoint 是 https://us-api.tokenhub.com/v1/chat/completions。

何時使用

適合先在小型倉庫或測試專案中驗證。先讓工具讀檔、解釋程式碼或產生方案，再逐步開啟修改和自動化任務。

安裝或開啟工具

先依照 Hermes Agent 官方文件安裝或開啟工具。版本不同時，請以官方文件目前的入口為準。

對於 CLI 工具，先確認可執行檔可用，再加入 TokenHub 憑證：

hermes --version

準備 TokenHub 憑證

建立 TokenHub API key，並在 TokenHub 模型列表中選擇一個適合這個工具的模型。

export TOKENHUB_API_KEY="sk-..."

請將金鑰保存在本機 shell、IDE 的密鑰儲存或工具的安全 API key 欄位中，不要提交到程式碼倉庫。

設定 TokenHub 服務商

在工具的模型、供應商、API Keys 或 OpenAI Compatible 設定頁面中填入下列值。

服務商填寫值

欄位	填寫值
供應商	OpenAI Compatible 或 Custom
Base URL	`https://us-api.tokenhub.com/v1`
API Key	`TOKENHUB_API_KEY` 的值
模型	`gpt-4.1` 或其他 TokenHub 模型 ID

設定檔位置

欄位	填寫值
Secret	`~/.hermes/.env`
Provider and model config	`~/.hermes/config.yaml`
Named custom provider	`tokenhub-custom`

TOKENHUB_API_KEY=sk-...

custom_providers:
  - name: tokenhub-custom
    base_url: '__API_BASE_URL__/v1'
    key_env: TOKENHUB_API_KEY
    api_mode: chat_completions

model:
  provider: 'custom:tokenhub-custom'
  default: 'gpt-4.1'

This follows Hermes' current named custom provider schema: base_url is the OpenAI-compatible Base URL, key_env reads the secret without writing it into YAML, and api_mode: chat_completions selects /v1/chat/completions.

Always keep the custom: prefix. Hermes treats bare tokenhub as a built-in provider alias; custom:tokenhub-custom unambiguously selects this self-hosted endpoint.

/model custom:tokenhub-custom:gpt-4.1

hermes chat

Hermes stores the named custom provider, Base URL, API mode, and default model in ~/.hermes/config.yaml. The API key remains in ~/.hermes/.env. You can also run hermes model, select Custom Endpoint, and enter the same values interactively.

如果工具將 chat、edit、apply 和 fast model 分開，第一次測試先全部使用同一個 TokenHub 模型。確認可用後，再依成本、延遲和推理能力拆分。

臨時環境變數只用於排錯

臨時變數適合確認 Key、網路和模型名。驗證通過後，請把同樣的值寫回上方的持久設定。

export TOKENHUB_API_KEY="sk-..."

驗證連線

先使用唯讀提示測試，確認模型能讀取上下文且不會改動檔案。成功後再測試編輯、Apply 或 Agent 任務。

閱讀目前專案的 README，請用三句話總結。不要修改任何檔案。

提示成功後，回到 TokenHub 請求記錄確認模型名稱、endpoint、token 用量和計費分組。

常見問題

現象	處理方式
401 或驗證失敗	確認 `TOKENHUB_API_KEY` 有效，且保存在同一個 terminal、IDE 或用戶端設定檔中。
404 或找不到模型	使用 TokenHub 工作區中存在，且符合所選協議的模型 ID。
endpoint 不正確	Base URL 必須與上方一致。OpenAI 相容工具通常需要 `/v1`；Claude 相容工具通常不需要。
請求逾時	檢查到 `https://us-api.tokenhub.com` 的網路、代理設定，以及工作區 allowlist。
工具使用了其他模型	重新檢查 chat、edit、apply、fast 或 autocomplete 等所有模型欄位。

Hermes 代理 TokenHub 設置

愛馬仕代理商是什麼？