OpenClaw 通过 OpenAI-compatible Provider 接入 Qwen、DeepSeek、GLM、Kimi 或代理网关时，如果后端返回 developer is not one of system/user/assistant/tool/function，通常是 developer role 没有映射为 system。本文结合 OpenClaw Issue #27037 和 PR #29479，整理 DeepAI API 中转站场景下的排查与修复方法。
OpenClaw 使用自定义 OpenAI-compatible Provider 时，如果请求里没有 tools 参数，模型可能只输出 JSON 文本而不会返回 tool_calls。本文结合 OpenClaw Issue #1866 / #8923，整理 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 中转站/自建代理如何同时兼容流式和非流式响应。
n8n OpenAI 节点使用 JSON mode / response_format=json_object 时，如果只显示 Internal Error，真实上游错误可能是 messages 或 instructions 没有包含 json 关键字。本文结合 n8n Issue #10206 和 1.56.0 修复，整理 DeepAI API 中转站场景下如何定位真实 400、补充 JSON 输出说明和 Schema 约束。
Hermes Agent 使用自定义 OpenAI-compatible 端点接入 API 中转站时，如果模型名以 gpt-5 开头，即使显式设置 api_mode=chat_completions，也可能被运行时强制切到 codex_responses，导致响应变慢或卡住。本文结合 Hermes Agent Issue #10473，整理 DeepAI API 中转站场景下的协议选择、模型命名和排查方法。
OpenClaw v2026.3.2 曾向所有 OpenAI-compatible Provider 强制发送 parallel_tool_calls:true，导致只支持单工具调用的模型返回 400 并让工具全部失效。本文结合 OpenClaw Issue #37048 和 PR #39356，整理 DeepAI API 中转站场景下如何识别、禁用和验证 parallel_tool_calls。
n8n Embeddings OpenAI 节点通过 OpenAI-compatible Embedding API 接入向量工作流时，如果返回全 0 向量，RAG 和 PGVector 检索会全部失效。本文结合 n8n Issue #16985 和 PR #20877，说明如何用 encodingFormat 参数修复 LM Studio 等兼容接口问题，并整理 DeepAI API 中转站场景下的排查方法。
OpenClaw memory-lancedb 插件过去只支持官方 OpenAI embedding 模型，不能配置 baseUrl、自定义模型名和 dimensions。本文结合 OpenClaw Issue #8118 与已合并修复 #17874，整理通过 DeepAI API 中转站接入 OpenAI-compatible Embedding Provider 的配置、排查和上线验证方法。
Hermes Agent 使用自定义 OpenAI-compatible 端点接入多模型 API 中转站时，如果 hermes model 总是锁定第一次选择的模型，根因可能是 custom_providers[].model 已保存导致提前返回，不再探测 /v1/models。本文结合 Hermes Agent Issue #6862，整理 DeepAI API 中转站多模型路由场景下的排查和修复思路。
Cline / Roo Code 类代码 Agent 通过 OpenAI-compatible Provider 接入中转站时，如果提示 You did not use a tool in your previous response，常见根因不是 Base URL，而是模型没有按 XML 工具格式输出、项目上下文过大或本地模型 context 太小。本文结合 Cline Issue #735，整理 DeepAI
Continue.dev 通过 OpenAI Provider 接入 API 中转站时，Chat 能正常请求 /chat/completions，但 Edit 和 Autocomplete 却请求旧 /completions 导致 405/404。本文结合 Continue Issue #3620，说明如何用 useLegacyCompletionsEndpoint:false 强制走 /chat/completions，并整理 DeepAI API 中转站场景下的排查方法。
n8n AI Agent / Tools Agent 通过 OpenAI-compatible Chat Model 接入 API 中转站时，如果后端返回 Cannot use tools with stream，根因通常是工具调用链路带了 stream:true。本文结合 n8n Issue #13112 和 PR #16888，整理 DeepAI API 中转站场景下的定位、修复和验证方法。