🚑 疑難排解
依症狀分類的問題排除,對應上游 GitHub issues
🚑 疑難排解
API key not set / API key 無效怎麼解？
Hermes Agent 出現 API key not set 或 key 無效的官方解法：hermes model 重設、config show 檢查、key 與供應商對應。
🚑 疑難排解
hermes: command not found 怎麼解？
裝完 Hermes Agent 卻出現 hermes: command not found 的官方解法：重載 shell、檢查 PATH、其他 shell 的設定。
🚑 疑難排解
Hermes requires Python 3.11 or newer 怎麼解？
Hermes Agent 報 Python 版本太舊的解法：檢查版本、升級方式、以及為什麼官方安裝器通常不會遇到這個問題。
🚑 疑難排解
Telegram 接 Hermes Agent 常見坑與解法
Hermes Agent 接 Telegram 的兩個官方已知坑：斜線指令 100 上限、WSL 下 gateway 斷線，含官方 config 解法。
🚑 疑難排解
context length exceeded 怎麼解？
Hermes Agent 出現 context length exceeded 的官方解法：/compress 壓縮 session、/usage 檢查用量、config.yaml 明確設定 context_length。
🚑 疑難排解
常見問題排解
Hermes Agent 安裝與執行常見錯誤的排解指南