Hermes Agent 接入 DeepAI、OpenAI Compatible API、自定义模型端点、部署和排错教程。
Hermes Agent 主模型能用，但 auxiliary title_generation 报 401 Missing Authentication header？可能是 provider:auto/openrouter 搭配 base_url 和空 api_key 被误判成 custom provider，跳过 OPENROUTER_API_KEY 环境变量读取。本文给出配置排查、workaround 和修复方向。
Hermes Agent 自定义 Skill 明明存在却不触发？可能是系统提示词里的 available_skills 只展示 description 前 60 字，关键触发词被截断。本文解释 .skills_prompt_snapshot.json、skills_list 1024 字差异和 60 字内 description 写法。
Hermes Agent 源码安装后报 ModuleNotFoundError: No module named agent.transports？这通常不是 Anthropic API Key 或模型名问题，而是 setuptools include 缺少 agent.*，导致 pip / Nix 安装产物漏掉 agent/transports 子包。
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 分层排查。