@@ -33,6 +33,14 @@ read_when:
|
33 | 33 | ```bash |
34 | 34 | openclaw models list --provider deepseek |
35 | 35 | ``` |
| 36 | + |
| 37 | +To inspect the bundled static catalog without requiring a running Gateway, |
| 38 | +use: |
| 39 | + |
| 40 | +```bash |
| 41 | +openclaw models list --all --provider deepseek |
| 42 | +``` |
| 43 | + |
36 | 44 | </Step> |
37 | 45 | </Steps> |
38 | 46 | |
@@ -73,6 +81,38 @@ DeepSeek `reasoning_content` on follow-up turns so thinking sessions with tool
|
73 | 81 | calls can continue. |
74 | 82 | </Tip> |
75 | 83 | |
| 84 | +## Thinking and tools |
| 85 | + |
| 86 | +DeepSeek V4 thinking sessions have a stricter replay contract than most |
| 87 | +OpenAI-compatible providers: when a thinking-enabled assistant message includes |
| 88 | +tool calls, DeepSeek expects the prior assistant `reasoning_content` to be sent |
| 89 | +back on the follow-up request. OpenClaw handles this inside the DeepSeek plugin, |
| 90 | +so normal multi-turn tool use works with `deepseek/deepseek-v4-flash` and |
| 91 | +`deepseek/deepseek-v4-pro`. |
| 92 | + |
| 93 | +When thinking is disabled in OpenClaw (including the UI **None** selection), |
| 94 | +OpenClaw sends DeepSeek `thinking: { type: "disabled" }` and strips replayed |
| 95 | +`reasoning_content` from the outgoing history. This keeps disabled-thinking |
| 96 | +sessions on the non-thinking DeepSeek path. |
| 97 | + |
| 98 | +Use `deepseek/deepseek-v4-flash` for the default fast path. Use |
| 99 | +`deepseek/deepseek-v4-pro` when you want the stronger V4 model and can accept |
| 100 | +higher cost or latency. |
| 101 | + |
| 102 | +## Live testing |
| 103 | + |
| 104 | +The direct live model suite includes DeepSeek V4 in the modern model set. To |
| 105 | +run only the DeepSeek V4 direct-model checks: |
| 106 | + |
| 107 | +```bash |
| 108 | +OPENCLAW_LIVE_PROVIDERS=deepseek \ |
| 109 | +OPENCLAW_LIVE_MODELS="deepseek/deepseek-v4-flash,deepseek/deepseek-v4-pro" \ |
| 110 | +pnpm test:live src/agents/models.profiles.live.test.ts |
| 111 | +``` |
| 112 | + |
| 113 | +That live check verifies both V4 models can complete and that thinking/tool |
| 114 | +follow-up turns preserve the replay payload DeepSeek requires. |
| 115 | + |
76 | 116 | ## Config example |
77 | 117 | |
78 | 118 | ```json5 |
|