- name
- deepseek-v4-reasoning-bug
- description
- 排查 DeepSeek V4-Pro 在 tool-call 模式下因 reasoning_content 字段缺失导致的 API 400 错误。适用场景：(1) DeepSeek V4-Pro 使用 thinking/reasoning 模式时遇到 400 error, (2) 报错内容为 'The reasoning_content in the thinking mode must be passed back to the API', (3) 与 OpenClaw/OpenAI-compatible 客户端集成时 multi-turn + tool call 场景下报错。包含触发条件、复现方法、临时 workaround、官方修复跟踪。
- metadata
- {"openclaw":{"homepage":"https://github.com/openclaw/openclaw/pulls?q=reasoning_content+deepseek"}}
DeepSeek V4-Pro reasoning_content Bug
使用方式
当报错文本中出现 The reasoning_content in the thinking mode must be passed back to the API.，优先把本技能当作 协议兼容性 / 消息回放问题 来排查，而不是先怀疑网络、余额或普通鉴权。
问题描述
V4-Pro 启用 thinking（推理）模式时，在多轮对话 + tool call 场景下，DeepSeek API 要求客户端的后续请求必须回传前一轮响应中的 reasoning_content 字段，否则返回 HTTP 400。
The reasoning_content in the thinking mode must be passed back to the API.触发条件
| 场景 | 结果 |
|---|---|
| 单轮对话（无工具） | ✅ 正常 |
| 单轮对话（有工具定义） | ✅ 正常 |
| 多轮对话（无工具调用） | ✅ 正常 |
| 多轮对话 + 工具调用 (tool call) | ❌ 400 报错 |
| 多轮对话 + 作为工具（tool）角色 | ❌ 400 报错 |
核心触发条件： Tool call 产生的 tool 角色消息之后，下一轮对话必须包含上一轮的 reasoning_content，否则报错。
DeepSeek 的约束要求
reasoning_content字段必须存在（值可以是空字符串""）reasoning_content完全缺失 → 400reasoning_content合并到content字段中 → 400（DeepSeek 只看字段名，不看内容位置）reasoning_content: ""（空字符串）→ ✅ 200 成功
因此最小修复方案是： 在回传给 DeepSeek 的 assistant 消息中，无条件添加 reasoning_content: "" 字段作为 fallback。
影响范围
- 任何使用 DeepSeek V4-Pro + thinking 模式的客户端都可能遇到
- OpenClaw 中：
convertMessages函数会过滤掉内容为空的 thinking block，导致reasoning_content字段完全缺失 - 不影响 V4-Flash（
reasoning: false，不产生reasoning_content） - 不影响单轮对话场景
排查方法
1. 确认是否是此 bug
检查 API 响应 body 中是否包含：
{
"error": {
"message": "The reasoning_content in the thinking mode must be passed back to the API."
}
}2. 确认触发场景
查看请求历史，确认是否有 assistant + tool_calls 消息后跟了 tool 角色消息。
3. 临时 workaround
如果必须在当前版本使用 V4-Pro + thinking，可以：
- 每次请求中手动向 assistant 消息添加
reasoning_content: "" - 或在消息处理管线中拦截 assistant 消息，无条件注入空
reasoning_content
4. 检查客户端版本
检查所使用的 DeepSeek SDK / 客户端版本是否已有修复。
临时决策建议
- 如果当前客户端未修复：不要把 V4-Pro thinking + tool-call 当作稳定主力链路
- 如果必须继续使用：优先采用“无条件补
reasoning_content: ""”的最小 fallback - 如果是纯单轮或无工具场景：可继续验证，但不要把该结果外推到多轮 tool-call 场景
官方修复状态
| PR | 作者 | 描述 | 状态 |
|---|---|---|---|
| #71105 | lsdsjy | DeepSeek 官方 provider 插件 + reasoning_content 回传修复 | Review 中 |
| #71146 | snowzlm | replay DeepSeek reasoning_content on tool-turn history | Review 中 |
两个 PR 于 2026-04-24 提交。修复方案都涉及在 tool-turn 历史消息中回传 reasoning_content 字段。
复现方法
import requests
# 1. 首次请求（带 thinking + tool calls）
response = requests.post("https://api.deepseek.com/v1/chat/completions", json={
"model": "deepseek-v4-pro",
"reasoning": {"effort": "low"},
"messages": [
{"role": "user", "content": "查询一下天气"}
],
"tools": [{"type": "function", "function": {"name": "get_weather", ...}}]
})
# 2. 模拟 tool call 结果
data = response.json()
assistant_msg = data["choices"][0]["message"]
# 3. 下次请求不传 reasoning_content → 会 400
bad_request = requests.post("https://api.deepseek.com/v1/chat/completions", json={
"model": "deepseek-v4-pro",
"reasoning": {"effort": "low"},
"messages": [
{"role": "user", "content": "查询一下天气"},
{
"role": "assistant",
"content": assistant_msg["content"],
"tool_calls": assistant_msg["tool_calls"],
# ❌ reasoning_content 缺失
},
{"role": "tool", "content": "晴，25°C", "tool_call_id": ...}
]
})
# → HTTP 400 ❌