Hermes Agent 使用 GPT-5.4、Copilot 或 OpenRouter 时，如果请求漂移到 /chat/completions 并报 unsupported_api_for_model，核心往往不是模型不可用，而是 GPT-5.x 必须走 Responses API / codex_responses。本文解释 provider fallback、api_mode、gateway 缓存和 OpenAI-compatible API 的正确排查顺序。
Hermes Agent 接入飞书 / Lark 后，危险命令审批卡片点击 Allow Once、Session、Always、Deny 报 200340？这通常不是模型 API 问题，而是 Feishu card.action.trigger、Interactive Card 与 Card Request URL 没配置完整。本文给出远程审批回调链路排查清单。
Hermes Agent 接入 Gemini provider 报 HTTP 400 Multiple authentication credentials received？这通常不是简单 API Key 粘错，而是 Google OpenAI-compatible endpoint、Bearer、x-goog-api-key、AIza legacy key 与 AQ 新 key 的认证兼容问题。本文总结排查顺序、临时绕法和 native Gemini adapter 的长期方向。
Hermes Agent 接入 Kimi for Coding 报 HTTP 400 invalid temperature: only 0.6 is allowed？这通常不是 API Key 错，而是模型固定参数契约没有覆盖主聊天、summary、memory flush、auxiliary client 等所有调用路径。本文总结 Kimi temperature 0.6 的正确排查方式。
Hermes Agent Matrix bot 能登录、同步旧消息、接受邀请，却完全不回复新消息？这通常不是模型 API 问题，而是 Matrix Gateway 的 sync / receive_response / callback 事件分发链路问题。本文基于真实修复讨论拆解 password login、device_id、initial sync、时间戳过滤和 DeepAI/OpenAI-compatible 分层排查。
Hermes Agent 热门已关闭 Issue #1083 复盘：OpenRouter、Nvidia、MiniMax 报 400 BadRequest，根因可能是 Hermes 把 reasoning extra_body 发给不支持的模型，也可能是 .env 中 API key 损坏。附 request dump 排查方法与 DeepAI/OpenAI-compatible 分层诊断思路。
Hermes Agent 热门已关闭 Issue #464 复盘：Ghostty、tmux、Warp 或 Docker Terminal 中输入框边框闪烁，根因并非模型 API，而是 thinking spinner 通过 raw stdout / \r 与 prompt_toolkit 渲染冲突。附 HERMES_SPINNER_PAUSE=1 hermes 排查方法。
Hermes 热门已关闭 Issue #7237 复盘：Response truncated due to output length limit、finish_reason=length、Truncated tool call 到底是 Hermes bug、模型输出限制，还是上下文太满？
Hermes 热门已关闭 issue #6475 复盘：Claude Desktop 能用，但 Hermes 通过 Anthropic subscription auth 报 HTTP 400 out of extra usage。为什么重启、重登、切换模型无效？如何改用更稳定的 API / OpenAI-compatible 路径？
Hermes 接入 OpenAI-compatible API 时，图片消息会变成 image_url content part。如果当前模型不是 vision model，就可能返回 HTTP 400。本文基于 Hermes PR #23750 讲清 non-vision model、多模态和 DeepAI 接入排错。
Hermes 主聊天正常，不代表 title generation、context compression、session search、background review 都正常。本文基于 GitHub Issues 解析 auxiliary client 502、aux provider routing、compression context length 和后台 review 输出泄漏。
OpenAI-compatible 不等于 provider 细节完全一致。本文基于 Hermes Issues 解析 reasoning_content 400、Custom Provider headers 403、上下文长度误判、delegate api_mode 继承等兼容性问题，并说明 DeepAI 接 Hermes 时该如何分层测试。