用戶端/Hermes Agent
在 Hermes Agent 中使用 Wokey API
取得 Wokey API 金鑰，將 Hermes Agent 的 Base URL 指向 Wokey，再用一個 curl 請求確認連線。
更新於
準備 API 金鑰與 Base URLlink
所有用戶端都使用同一組 Wokey API 金鑰和同一個 Base URL。
使用 Wokey Base URL
用戶端的 Base URL 填入閘道網域；是否加上 /v1 請參考下方設定。
設定用戶端link
Hermes Agent 只需要前五行設定，用來指定模型、自訂供應商、Base URL 與 API 金鑰。使用 GPT 模型（例如 gpt-6-sol）時，請加上 api_mode: codex_responses 以獲得最佳快取命中率；Claude 等其他模型不要加。
# ~/.hermes/config.yaml
model:
default: claude-opus-5-5
provider: custom
base_url: https://api.wokey.ai
api_key: YOUR_API_KEY
# 僅限 GPT 模型（例如 gpt-6-sol）— 取消註解以獲得最佳快取命中率：
# api_mode: codex_responsesAPI 格式與 Base URLlink
同一個用戶端切換 API 格式時，Base URL 結尾是否帶 /v1 可能不同。
| 格式 | Base URL | 適用於 |
|---|---|---|
| OpenAI Chat Completions | https://api.wokey.ai | DeepSeek、GLM、Kimi 等其他模型 |
設定位置: ~/.hermes/config.yaml
用 Opus 5.5 把 Hermes Agent 跑成常駐代理：與 Claude Duet 的差異link
Anthropic 在 2026-10-21 推出了 Claude Duet 研究預覽：由 Claude Opus 5.5 驅動的主動型代理，每天早上傳送簡報，在背景監看你已連接的應用程式，動手前先詢問你。Duet 只能登入 Claude 帳號使用，沒有 API 金鑰或自訂 Base URL，因此無法透過 Wokey 執行。Hermes Agent 是開源、自行託管的常駐代理，接上 Wokey 後即可使用同一個 Opus 5.5 模型，不必排候補名單，也不限地區。
| Claude Duet | Hermes Agent + Wokey | |
|---|---|---|
| 模型 | Claude Opus 5.5，無法更換 | claude-opus-5-5，或 Wokey 上的任何其他模型 |
| 誰能使用 | 美國的 Claude Pro 與 Max 訂閱者，需排候補名單；Team 與 Enterprise 尚未支援 | 自行安裝，有 Wokey API 金鑰即可，不限地區 |
| 費用 | 預覽期間不另收費，但與聊天、Claude Code 共用方案的用量上限，背景檢查也計算在內 | 依 token 計費，從 Wokey 餘額扣除；檢查頻率由你決定 |
| 在哪裡執行 | Anthropic 雲端上的虛擬機器，內建瀏覽器；手機和筆電關機後仍持續運作 | 你自己的電腦或伺服器；要全天候運作就部署在常開的機器上 |
| 如何與它對話 | Duet App（iOS 與 Android）和 claude.ai | Telegram、Slack 等聊天應用程式 |
| 記憶與工具 | 沿用 Claude 帳號的記憶、skills 與連接器 | 記憶、skills 與工具都在本機，由你自行安裝與管理 |
| 動手前確認 | 傳送訊息、付款、簽署或刪除前都會先詢問；證券交易與帳戶間轉帳一律不允許 | 權限與確認規則由你設定；只授權它需要的帳號 |
- 依 token 計費時，檢查越頻繁費用越高：每次檢查都會重新傳送系統提示與記憶。例行檢查可改用較便宜的模型（例如 claude-sonnet-5-5 或 deepseek-v4.1-flash），需要判斷與動手時再切換到 Opus 5.5。
- 透過 Chat Completions 呼叫時，Opus 5.5 會先思考再輸出，因此第一個 token 較慢；在背景運作的代理幾乎不受影響。
- 上方設定預設就是 claude-opus-5-5，不需要修改。
Duet 資訊查核日期 2026-10-22 · Duet 資訊來源：Introducing Claude Duet · Claude Duet FAQ
用 curl 驗證link
用戶端回報錯誤時，先用 curl 排除金鑰與 Base URL 的問題。
Hermes Agent 預設使用 OpenAI Chat Completions 格式。這個請求回傳 200，代表金鑰和 Base URL 都正確；送出前請把 YOUR_API_KEY 換成你的金鑰。
curl https://api.wokey.ai/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-sol",
"messages": [
{ "role": "user", "content": "Hello" }
]
}'錯誤與疑難排解link
先區分認證、餘額、限流、模型無法使用與上游逾時等情況。
invalid api key
金鑰缺少、輸入錯誤、已刪除，或 Authorization 與 x-api-key 標頭內容衝突。
insufficient balance
帳號餘額不足。請先儲值再繼續送出請求。
model_denylisted / account_restricted
因重複違規，對該模型或帳號下所有模型的呼叫已被暫停。請參閱「違規處理費與限制」。
request_blocked
這個請求在送達上游前就被攔截，不會計費，例如原封不動地重送模型剛拒答的請求，或來自已暫停的終端使用者（X-End-User-Id）。錯誤訊息會說明被攔截的原因；請依訊息修改請求或稍後重試。其他請求不受影響。
rate limited
請求過於頻繁。請稍後重試或降低並行數。若只有某一個模型或某一個終端使用者（X-End-User-Id）持續回傳 429，可能是違規後的暫時限制。
client disconnected
用戶端在回應完成前關閉了連線（代碼 downstream_aborted）。預設不收費。當帳號在過去 24 小時內至少有 50 次用戶端中斷，且占其請求的 10% 以上時，之後中斷的請求會依上游回報的用量計費：已處理的輸入（含快取讀取與寫入），以及僅在上游有計入時的輸出。在上游回報任何用量之前就中斷的請求仍然免費。開始計費時會通知帳號，中斷率恢復正常後一小時內會自動停止計費。常見原因是用戶端或代理的逾時設定太短，或程式在請求完成前就取消了請求。
upstream unavailable
上游模型服務暫時無法使用。請切換模型或稍後重試。
upstream timeout
上游回應逾時。請縮短上下文、調低 max_tokens 或重試。
upstream overloaded
上游模型暫時過載，Wokey 已經在其他路由上重試過（代碼 upstream_overloaded）。這與你的餘額無關。請稍後重試或切換模型。
常見問題link
- Hermes Agent 的 base_url 要不要加 /v1？
- 不用，base_url 填 https://api.wokey.ai，provider 填 custom。
- 什麼時候要加 api_mode: codex_responses？
- 只有使用 GPT 模型（例如 gpt-6-sol）時才加這一行，快取命中率最好。Claude 等其他模型請不要加。
- API 金鑰要寫在哪裡？
- 寫在 ~/.hermes/config.yaml 中 model 底下的 api_key 欄位，只填金鑰本身。