The Hermes Bible — 繁體中文版

Hermes Agent 透過基於瀏覽器的 OAuth 登入流程支援 MiniMax，使用與 MiniMax 入口網站相同的憑證。不需要 API 金鑰或信用卡 — 登入一次，Hermes 會自動重新整理你的工作階段。

傳輸層重用 anthropic_messages 適配器（MiniMax 在 /anthropic 上公開了一個 Anthropic Messages 相容端點），因此所有現有的工具呼叫、串流和上下文功能無需任何適配器變更即可運作。

概覽

項目	值
供應商 ID	`minimax-oauth`
顯示名稱	MiniMax (OAuth)
認證類型	瀏覽器 OAuth（PKCE 重新導向流程）
傳輸	Anthropic Messages 相容（`anthropic_messages`）
模型	`MiniMax-M2.7`、`MiniMax-M2.7-highspeed`
全球端點	`https://api.minimax.io/anthropic`
中國端點	`https://api.minimaxi.com/anthropic`
需要環境變數	否（此供應商不使用 `MINIMAX_API_KEY`）

前置需求

Python 3.9+
Hermes Agent 已安裝
在 minimax.io（全球）或 minimaxi.com（中國）的 MiniMax 帳戶
本機上有可用的瀏覽器（或使用 --no-browser 用於遠端工作階段）

快速開始

# 啟動供應商和模型選擇器
hermes model
# → 從供應商清單中選擇 "MiniMax (OAuth)"
# → Hermes 開啟瀏覽器到 MiniMax 授權頁面
# → 在瀏覽器中批准存取
# → 選擇一個模型（MiniMax-M2.7 或 MiniMax-M2.7-highspeed）
# → 開始聊天

hermes

首次登入後，憑證儲存在 ~/.hermes/auth.json 下，並在每個工作階段開始前自動重新整理。

手動登入

你可以不透過模型選擇器觸發登入：

hermes auth add minimax-oauth

中國區域

如果你的帳戶在中國平台（minimaxi.com）上，請改用基於 API 金鑰的 minimax-cn 供應商 — minimax-cn 僅以 auth_type="api_key" 註冊（無 OAuth 流程）。直接設定 MINIMAX_CN_API_KEY（以及可選的 MINIMAX_CN_BASE_URL）：

echo 'MINIMAX_CN_API_KEY=your-key' >> ~/.hermes/.env

遠端 / 無頭工作階段

在沒有瀏覽器的伺服器或容器上：

hermes auth add minimax-oauth --no-browser

Hermes 會列印驗證 URL 和使用者代碼 — 在任何裝置上開啟 URL 並在提示時輸入代碼。

OAuth 流程

Hermes 對 MiniMax OAuth 端點實施 PKCE 瀏覽器 OAuth 流程：

Hermes 產生一對 PKCE 驗證者/挑戰和一個隨機狀態值。
它向 {base_url}/oauth/code 發送 POST，攜帶挑戰並接收 user_code 和 verification_uri。
你的瀏覽器開啟 verification_uri。如果提示，輸入 user_code。
Hermes 輪詢 {base_url}/oauth/token 直到權杖到達（或截止期限到達）。
權杖（access_token、refresh_token、到期時間）儲存到 ~/.hermes/auth.json 下的 minimax-oauth 鍵中。

權杖重新整理（標準 OAuth refresh_token 授權）在每個工作階段開始時自動運行，當存取代碼距離到期 60 秒內時。

檢查登入狀態

hermes doctor

◆ Auth Providers 部分會顯示：

✓ MiniMax OAuth  (logged in, region=global)

或未登入時：

⚠ MiniMax OAuth  (not logged in)

切換模型

hermes model
# → 選擇 "MiniMax (OAuth)"
# → 從模型清單中選擇

或直接設定模型：

hermes config set model.default MiniMax-M2.7
hermes config set model.provider minimax-oauth

設定參考

登入後，~/.hermes/config.yaml 將包含類似的條目：

model:
  default: MiniMax-M2.7
  provider: minimax-oauth
  base_url: https://api.minimax.io/anthropic

區域端點

供應商 ID	入口網站	推論端點
`minimax-oauth`（全球）	`https://api.minimax.io`	`https://api.minimax.io/anthropic`
`minimax-cn`（中國）	`https://api.minimaxi.com`	`https://api.minimaxi.com/anthropic`

供應商別名

以下全部解析為 minimax-oauth：

hermes --provider minimax-oauth    # 規範
hermes --provider minimax-portal   # 別名
hermes --provider minimax-global   # 別名
hermes --provider minimax_oauth    # 別名（底線形式）

環境變數

minimax-oauth 供應商不使用 MINIMAX_API_KEY 或 MINIMAX_BASE_URL。這些變數僅用於基於 API 金鑰的 minimax 和 minimax-cn 供應商。

變數	效果
`MINIMAX_API_KEY`	僅由 `minimax` 供應商使用 — 對 `minimax-oauth` 忽略
`MINIMAX_CN_API_KEY`	僅由 `minimax-cn` 供應商使用 — 對 `minimax-oauth` 忽略

要使用 minimax-oauth 作為活動供應商，在 config.yaml 中設定 model.provider: minimax-oauth（使用 hermes setup 進行引導流程），或在單次呼叫中傳遞 --provider minimax-oauth：

hermes --provider minimax-oauth

模型

模型	最適合
`MiniMax-M2.7`	長上下文推理、複雜工具呼叫
`MiniMax-M2.7-highspeed`	較低延遲、較輕量的任務、輔助呼叫

兩個模型都支援最多 200,000 代幣的上下文。

當 minimax-oauth 是主要供應商時，MiniMax-M2.7-highspeed 也自動用於視覺和委託任務的輔助模型。

疑難排解

權杖過期 — 未自動重新登入

Hermes 在每個工作階段開始時重新整理權杖，如果它距離到期 60 秒內。如果存取代碼已經過期（例如在長時間離線後），重新整理會在下一個請求時自動發生。如果重新整理因 refresh_token_reused 或 invalid_grant 失敗，Hermes 會將工作階段標記為需要重新登入。

當重新整理失敗是終結性的（HTTP 4xx、invalid_grant、撤銷的授權等）時，Hermes 會將重新整理代碼標記為死亡並在本機隔離它，這樣它就不會持續重播失敗的交換。代理程式會顯示單一的「需要重新認證」訊息，並在你再次登入之前保持靜默。

修正： 再次執行 hermes auth add minimax-oauth 以開始新的登入。隔離會在下一次成功的交換時清除。

授權逾時

裝置代碼流程有有限的到期窗口。如果你未及時批准登入，Hermes 會引發逾時錯誤。

修正： 重新執行 hermes auth add minimax-oauth（或 hermes model）。流程會重新開始。

狀態不匹配（可能的 CSRF）

Hermes 偵測到授權伺服器傳回的 state 值與其傳送的不匹配。

修正： 重新執行登入。如果持續存在，檢查是否有代理或重新導向正在修改 OAuth 回應。

從遠端伺服器登入

如果 hermes 無法開啟瀏覽器視窗，使用 --no-browser：

hermes auth add minimax-oauth --no-browser

Hermes 列印 URL 和代碼。在任何裝置上開啟 URL 並在那裡完成流程。

運行時出現「Not logged into MiniMax OAuth」錯誤

認證儲存中沒有 minimax-oauth 的憑證。你尚未登入，或憑證檔案已被刪除。

修正： 執行 hermes model 並選擇 MiniMax (OAuth)，或執行 hermes auth add minimax-oauth。

登出

要移除已儲存的 MiniMax OAuth 憑證：

hermes auth remove minimax-oauth

概覽