From 3a64aa49a9014518fa1977fbc023f3e0b978ae5d Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Fri, 24 Apr 2026 16:30:14 +0100
Subject: [PATCH] docs(deepseek): expand v4 testing notes

---
 docs/providers/deepseek.md | 40 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/docs/providers/deepseek.md b/docs/providers/deepseek.md
index 412f2ee6d6b..2209c9e3e4d 100644
--- a/docs/providers/deepseek.md
+++ b/docs/providers/deepseek.md
@@ -33,6 +33,14 @@ read_when:
     ```bash
     openclaw models list --provider deepseek
     ```
+
+    To inspect the bundled static catalog without requiring a running Gateway,
+    use:
+
+    ```bash
+    openclaw models list --all --provider deepseek
+    ```
+
   </Step>
 </Steps>
 
@@ -73,6 +81,38 @@ DeepSeek `reasoning_content` on follow-up turns so thinking sessions with tool
 calls can continue.
 </Tip>
 
+## Thinking and tools
+
+DeepSeek V4 thinking sessions have a stricter replay contract than most
+OpenAI-compatible providers: when a thinking-enabled assistant message includes
+tool calls, DeepSeek expects the prior assistant `reasoning_content` to be sent
+back on the follow-up request. OpenClaw handles this inside the DeepSeek plugin,
+so normal multi-turn tool use works with `deepseek/deepseek-v4-flash` and
+`deepseek/deepseek-v4-pro`.
+
+When thinking is disabled in OpenClaw (including the UI **None** selection),
+OpenClaw sends DeepSeek `thinking: { type: "disabled" }` and strips replayed
+`reasoning_content` from the outgoing history. This keeps disabled-thinking
+sessions on the non-thinking DeepSeek path.
+
+Use `deepseek/deepseek-v4-flash` for the default fast path. Use
+`deepseek/deepseek-v4-pro` when you want the stronger V4 model and can accept
+higher cost or latency.
+
+## Live testing
+
+The direct live model suite includes DeepSeek V4 in the modern model set. To
+run only the DeepSeek V4 direct-model checks:
+
+```bash
+OPENCLAW_LIVE_PROVIDERS=deepseek \
+OPENCLAW_LIVE_MODELS="deepseek/deepseek-v4-flash,deepseek/deepseek-v4-pro" \
+pnpm test:live src/agents/models.profiles.live.test.ts
+```
+
+That live check verifies both V4 models can complete and that thinking/tool
+follow-up turns preserve the replay payload DeepSeek requires.
+
 ## Config example
 
 ```json5