API key not set / API key 無效怎麼解？

看到 API key not set 就跑 hermes model 重新設定供應商，或直接 hermes config set OPENROUTER_API_KEY your_key；key 無效多半是填了不對應供應商的 key。

這頁適合誰：設定模型階段卡住、或換供應商後開始報錯的人。

步驟

重新設定供應商
```
hermes model
```

或直接寫入 key

hermes config set OPENROUTER_API_KEY your_key

檢查目前設定
```
hermes config show
```
更新後設定不見了？

官方文件提供 config 檢查與遷移指令。
```
hermes config check
hermes config migrate
```

完成後怎麼驗證

hermes config show 顯示正確供應商
對話正常回覆

常見問題

key 明明是對的還是失敗？

官方 FAQ 特別提醒：key 必須對應供應商，OpenAI 的 key 不能用在 OpenRouter，反之亦然。

模型顯示不可用？

用 hermes model 列出可用模型，或明確指定：hermes config set HERMES_MODEL anthropic/claude-opus-4.7。

相關頁