Hermes Agent 报 UnicodeEncodeError: ascii codec can't encode character？本文从 LANG=C、API Key 混入 Unicode 近似字符、OpenAI SDK Authorization header、tool schema、api_messages 和 reasoning_content 角度给出完整排错清单。
Hermes Agent 接入 Ollama 后同一会话记不住上一轮？这可能不是 memory tool 坏了，而是 Ollama num_ctx 回落到 2048 导致历史被服务端静默截断。本文解释 context_length、ollama_num_ctx、/api/show 探测失败和 PR #19613 的修复方向。
Hermes Agent 使用 Gemini 3 / preview 模型时报 Function call is missing a thought_signature？这通常不是 API Key 或网络问题，而是 tool call 历史消息丢失 extra_content / thought_signature。本文整理升级、复现和源码排查清单。
Hermes Agent 接入 DeepSeek thinking 模型时报 reasoning_content 或 content[].thinking must be passed back？这通常不是 API Key 错，而是历史 assistant message 在工具调用、fallback、cron 或 replay 时丢失 thinking 字段。本文整理 DeepSeek provider detection、reasoning_content echo 和排查清单。
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、模型输出限制，还是上下文太满？