Hermes Agent 接入 DeepAI、OpenAI Compatible API、自定义模型端点、部署和排错教程。
Clash、Mihomo、Sing-box、Surge 开启 TUN/Fake-IP 后，Hermes 访问普通网站却报 Blocked: URL targets a private or internal address？本文解释 198.18.0.0/15 RFC2544 网段、Python ipaddress.is_private、SSRF 防护误拦和 allow_private_urls 的安全取舍。
Hermes openai-codex 路径中，用户要求机器人不回复时，completed empty final answer 曾被归一化成 incomplete 并重试 3 次。本文解释空响应不等于未完成、finish_reason 误判、continuation loop 和群聊机器人“沉默成功”的重要性。
Hermes 升级后 Matrix、Telegram、飞书突然报 cannot import name cfg_get？这通常不是平台配置或模型 API 问题，而是 Gateway 仍在运行旧代码/旧 import 状态。本文解释为什么 /reset 无效、gateway restart 有效，以及多 profile/system service 排查方法。
Hermes Telegram 反复提示 Interrupting current task，但 /stop 又说 No active task to stop？这通常是 Gateway adapter._active_sessions 与 runner._running_agents 状态分裂导致的 stale busy lock。本文解释症状、/restart 临时恢复和 #14513 修复方向。
Hermes Telegram Gateway 里 /model 看得到却不生效？本文解释 /model 被移除、CLI 切换不影响 Telegram session、Agent 幻觉式声称已切换，以及如何用日志和 provider 账单验证真实模型。
Hermes update 在 macOS 上卡在 python-olm==3.2.16？本文解释 CMake 4 policy、Apple Clang 21、vendored libolm、matrix-nio[e2e] 与可选依赖拆分的排查和绕过方法。
Hermes 接入 OpenRouter、MiniMax 或 NVIDIA 模型时一发请求就 BadRequestError 400？问题可能不是 API Key，而是 reasoning extra_body 被发给了不支持 reasoning 扩展的模型。本文教你读 request_dump 并分层排查。
Hermes CLI 输入 @ 触发文件补全时抛出 NameError: self is not defined？本文解释 _context_completions、@staticmethod、fuzzy file completions 的根因、临时绕过和升级修复路径。
Hermes config set GITHUB_TOKEN 后，Docker terminal 里仍读不到环境变量？这可能是 Docker exec 只转发当前 shell env，却没加载 ~/.hermes/.env。本文解释 GITHUB_TOKEN、docker_forward_env、~/.gitconfig 挂载和容器内 printenv 排查方法。
Hermes Agent 运行 hermes 或 hermes chat 刚显示 banner 就崩溃，报 Error: Invalid key: c-S-c？这通常不是 API Key 或模型问题，而是 prompt_toolkit 不支持 Ctrl+Shift+C 的 c-S-c keybinding。本文解释原因、判断方法、临时 workaround 和升级建议。
Hermes Agent 主模型正常，但 title_generation 报 HTTP 404？可能是 auxiliary provider:auto 没跟随主 provider，而是选到 fallback provider（如 minimax），导致 SDK、api_mode 或 endpoint path 不匹配。本文解释 provider:auto、fallback_model、WeChat 错误泄露和显式配置 workaround。