Hermes Agent 接入 DeepAI、OpenAI Compatible API、自定义模型端点、部署和排错教程。
Hermes Agent 使用 custom GPT-5 OpenAI-compatible 网关时，多轮会话可能因历史里出现空 function_call.name 或空 tool_call_id，触发 Responses API 400：Invalid input[n].name empty string。本文结合 Hermes Agent Issue #11411，整理 DeepAI API 中转站日志、工具调用历史清洗和协议选择排查方法。
OpenClaw openai-completions Provider 默认发送 stream:true，如果自定义 OpenAI-compatible model-router 只返回单个 chat.completion JSON，界面可能沉默不显示。本文结合 OpenClaw Issue #14262，说明为什么 stream:true 必须返回 text/event-stream SSE chunk，以及 DeepAI API 中转站/自建代理如何同时兼容流式和非流式响应。
Hermes Agent 使用自定义 OpenAI-compatible 端点接入 API 中转站时，如果模型名以 gpt-5 开头，即使显式设置 api_mode=chat_completions，也可能被运行时强制切到 codex_responses，导致响应变慢或卡住。本文结合 Hermes Agent Issue #10473，整理 DeepAI API 中转站场景下的协议选择、模型命名和排查方法。
Hermes Agent 使用自定义 OpenAI-compatible 端点接入多模型 API 中转站时，如果 hermes model 总是锁定第一次选择的模型，根因可能是 custom_providers[].model 已保存导致提前返回，不再探测 /v1/models。本文结合 Hermes Agent Issue #6862，整理 DeepAI API 中转站多模型路由场景下的排查和修复思路。
OpenClaw 通过 OpenAI-compatible 网关调用 Gemini 工具时，第一次 tool call 成功但回传 tool result 后 400，提示缺少 thought_signature 怎么办？本文结合 OpenClaw GitHub 已关闭 Issue，整理 DeepAI API 中转站、provider-specific metadata、tool_calls 和工具结果回传排查方法。
Hermes Agent 自动上下文压缩时，辅助模型请求因 max_tokens 参数被新模型拒绝并返回 400，导致 fallback context marker 和上下文丢失怎么办？本文结合 Hermes Agent GitHub 已关闭 Issue，整理 DeepAI API 中转站、多模型路由、max_completion_tokens 和辅助任务参数兼容排查方法。
Hermes Agent 使用 custom OpenAI-compatible Provider 时，主模型能用但 approval、compression、title generation 等辅助任务 fallback 到错误端点怎么办？本文结合 Hermes Agent GitHub 已关闭 Issue，整理 DeepAI API 中转站接入、config.yaml 显式配置和日志排查方法。
Hermes Agent 已关闭 issue #26428 复盘：active provider 设置为 OpenRouter 但缺少 API Key 时，runtime 报 No LLM provider configured，而 hermes doctor summary 不够明确。本文面向 DeepAI API 中转站用户讲清 Provider、Base URL、API Key 和 Model
Hermes Agent 已解决 Langfuse placeholder key 静默失败、trace 缺少 input/output、post_tool_call 不触发等观测问题。本文面向 DeepAI API 中转站用户，讲清可观测性、日志完整性和 hook 排查顺序。
面向 DeepAI API 中转站用户的 Hermes Agent 排查教程：从已关闭 GitHub issue 看 web_tools 批量网页提取为什么会因单个任务失败丢掉整批结果，并区分模型、API 中转站和 Agent 工具层问题。
自定义 OpenAI-compatible Base URL 调用 gpt-4o、gpt-4.1、gpt-5 或 o-series 模型时，为什么会报 Unsupported parameter: max_tokens？本文复盘 Hermes Agent #13901，解释 max_tokens / max_completion_tokens 不能只按 host 判断，而应按模型族和后端能力适配，并自然引导到 DeepAI API 中转站的统一接入场景。
Hermes 的 hermes completion zsh 曾生成不合法的 Zsh _arguments 语法，例如 (-h --help){-h,--help}，导致 _arguments:comparguments: invalid argument。本文客观复盘 #22686：为什么 exclusion group 不能混入长选项、如何改成 (-){-h,--help}，以及如何用 zsh -n 做回归验证。