🚑 疑難排解
依症狀分類的問題排除,對應上游 GitHub issues
🚑 疑難排解 v>=2026.5
API key not set / API key 無效怎麼解
最常見的原因不是 key 打錯,是 key 跟供應商配錯了。三步驟排查,含 ~/.hermes/.env 的衝突設定。
🚑 疑難排解 v>=2026.5
hermes: command not found 怎麼解
裝完打 hermes 卻說找不到指令——九成不是安裝失敗,是 shell 還沒重新載入 PATH。三十秒可解。
🚑 疑難排解
常見問題排解
Hermes Agent 安裝與執行常見錯誤的排解指南
🚑 疑難排解 v>=2026.5
Hermes requires Python 3.11 or newer 怎麼解
會遇到這個錯,通常代表你沒走官方安裝器。三種解法,含「為什麼別人不會遇到」。
🚑 疑難排解
Telegram 接 Hermes Agent 常見坑與解法
Hermes Agent 接 Telegram 的兩個官方已知坑：斜線指令 100 上限、WSL 下 gateway 斷線，含官方 config 解法。
🚑 疑難排解 v>=2026.5
context length exceeded 怎麼解
先用 /compress 救回當前對話,再從設定根治。本地模型使用者特別容易踩到——原因跟你想的不一樣。