---
read_when:
- Je wilt OpenClaw uitvoeren op antirez/ds4
- Je wilt een lokale DeepSeek V4 Flash-backend met toolaanroepen
- Je hebt de OpenClaw-configuratie voor ds4-server nodig
summary: OpenClaw uitvoeren via ds4, een lokale OpenAI-compatibele DeepSeek V4 Flash-server
title: ds4
x-i18n:
generated_at: "2026-06-27T18:12:11Z"
model: gpt-5.5
postprocess_version: locale-links-v1
provider: openai
source_hash: a9922421d39f5d2d29dfa62de9fc3de7131dfa96445d0646cd02ad766a125544
source_path: providers/ds4.md
workflow: 16
---
[ds4](https://github.com/antirez/ds4) serveert DeepSeek V4 Flash vanuit een lokale
Metal-backend met een OpenAI-compatibele `/v1`-API. OpenClaw maakt verbinding met ds4
via de generieke `openai-completions`-providerfamilie.
ds4 is geen gebundelde OpenClaw-provider-Plugin. Configureer het onder
`models.providers.ds4` en selecteer daarna `ds4/deepseek-v4-flash`.
- Provider-id: `ds4`
- Plugin: geen
- API: OpenAI-compatibele Chat Completions (`openai-completions`)
- Voorgestelde basis-URL: `http://127.0.0.1:18000/v1`
- Model-id: `deepseek-v4-flash`
- Toolaanroepen: ondersteund via OpenAI-stijl `tools` en `tool_calls`
- Redeneren: DeepSeek-stijl `thinking` en `reasoning_effort`
## Vereisten
- macOS met Metal-ondersteuning.
- Een werkende ds4-checkout met `ds4-server` en het DeepSeek V4 Flash GGUF-bestand.
- Genoeg geheugen voor de context die je kiest. Grotere `--ctx`-waarden wijzen meer
KV-geheugen toe wanneer de server start.
OpenClaw-agentbeurten bevatten toolschema's en werkruimtecontext. Een kleine context
zoals `--ctx 4096` kan directe curl-tests doorstaan maar volledige agentruns laten mislukken met
`500 prompt exceeds context`. Gebruik minstens `--ctx 32768` voor agent- en tool-
smoketests. Gebruik `--ctx 393216` alleen wanneer je genoeg geheugen hebt en ds4
Think Max-gedrag wilt.
## Snelstart
Vervang `` door het pad naar je ds4-checkout.
```bash
/ds4-server \
--model /ds4flash.gguf \
--host 127.0.0.1 \
--port 18000 \
--ctx 32768 \
--tokens 128
```
```bash
curl http://127.0.0.1:18000/v1/models
```
Het antwoord moet `deepseek-v4-flash` bevatten.
Voeg de configuratie uit [Volledige configuratie](#full-config) toe en voer daarna een eenmalige modelcontrole
uit:
```bash
openclaw infer model run \
--local \
--model ds4/deepseek-v4-flash \
--thinking off \
--prompt "Reply with exactly: openclaw-ds4-ok" \
--json
```
## Volledige configuratie
Gebruik deze configuratie wanneer ds4 al draait op `127.0.0.1:18000`.
```json5
{
agents: {
defaults: {
model: { primary: "ds4/deepseek-v4-flash" },
models: {
"ds4/deepseek-v4-flash": {
alias: "DS4 local",
},
},
},
},
models: {
mode: "merge",
providers: {
ds4: {
baseUrl: "http://127.0.0.1:18000/v1",
apiKey: "ds4-local",
api: "openai-completions",
timeoutSeconds: 300,
models: [
{
id: "deepseek-v4-flash",
name: "DeepSeek V4 Flash (ds4)",
reasoning: true,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 32768,
maxTokens: 128,
compat: {
supportsUsageInStreaming: true,
supportsReasoningEffort: true,
maxTokensField: "max_tokens",
supportsStrictMode: false,
thinkingFormat: "deepseek",
supportedReasoningEfforts: ["low", "medium", "high", "xhigh"],
},
},
],
},
},
},
}
```
Houd `contextWindow` afgestemd op de waarde van `ds4-server --ctx`. Houd `maxTokens`
afgestemd op `--tokens`, tenzij je OpenClaw bewust minder uitvoer wilt laten aanvragen
dan de serverstandaard.
## Opstarten op aanvraag
OpenClaw kan ds4 alleen starten wanneer een `ds4/...`-model is geselecteerd. Voeg
`localService` toe aan dezelfde providervermelding:
```json5
{
models: {
providers: {
ds4: {
baseUrl: "http://127.0.0.1:18000/v1",
apiKey: "ds4-local",
api: "openai-completions",
timeoutSeconds: 300,
localService: {
command: "/ds4-server",
args: [
"--model",
"/ds4flash.gguf",
"--host",
"127.0.0.1",
"--port",
"18000",
"--ctx",
"32768",
"--tokens",
"128",
],
cwd: "",
healthUrl: "http://127.0.0.1:18000/v1/models",
readyTimeoutMs: 300000,
idleStopMs: 0,
},
models: [
{
id: "deepseek-v4-flash",
name: "DeepSeek V4 Flash (ds4)",
reasoning: true,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 32768,
maxTokens: 128,
compat: {
supportsUsageInStreaming: true,
supportsReasoningEffort: true,
maxTokensField: "max_tokens",
supportsStrictMode: false,
thinkingFormat: "deepseek",
supportedReasoningEfforts: ["low", "medium", "high", "xhigh"],
},
},
],
},
},
},
}
```
`command` moet een absoluut pad naar een uitvoerbaar bestand zijn. Shell-lookup en `~`-uitbreiding worden
niet gebruikt. Zie [Lokale modelservices](/nl/gateway/local-model-services) voor elk
`localService`-veld.
## Think Max
ds4 past Think Max alleen toe wanneer aan beide voorwaarden is voldaan:
- `ds4-server` start met `--ctx 393216` of hoger.
- De aanvraag gebruikt `reasoning_effort: "max"` of het equivalente ds4-effortveld.
Als je die grote context gebruikt, werk dan zowel de serverflags als de OpenClaw-modelmetadata
bij:
```json5
{
contextWindow: 393216,
maxTokens: 384000,
compat: {
supportsUsageInStreaming: true,
supportsReasoningEffort: true,
maxTokensField: "max_tokens",
supportsStrictMode: false,
thinkingFormat: "deepseek",
supportedReasoningEfforts: ["low", "medium", "high", "xhigh", "max"],
},
}
```
## Testen
Begin met een directe HTTP-controle:
```bash
curl http://127.0.0.1:18000/v1/chat/completions \
-H 'content-type: application/json' \
-d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"Reply with exactly: ds4-ok"}],"max_tokens":16,"stream":false,"thinking":{"type":"disabled"}}'
```
Test daarna OpenClaw-modelroutering:
```bash
openclaw infer model run \
--local \
--model ds4/deepseek-v4-flash \
--thinking off \
--prompt "Reply with exactly: openclaw-ds4-ok" \
--json
```
Gebruik voor een volledige agent- en toolaanroep-smoketest een context van minstens 32768:
```bash
openclaw agent \
--local \
--session-id ds4-tool-smoke \
--model ds4/deepseek-v4-flash \
--thinking off \
--message "Use the shell command pwd once, then reply exactly: tool-ok