--- read_when: - Sie möchten OpenClaw mit antirez/ds4 ausführen - Sie möchten ein lokales DeepSeek V4 Flash-Backend mit Tool-Aufrufen - Sie benötigen die OpenClaw-Konfiguration für ds4-server summary: OpenClaw über ds4 ausführen, einen lokalen, OpenAI-kompatiblen DeepSeek V4 Flash-Server title: ds4 x-i18n: generated_at: "2026-06-27T18:03:32Z" 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) stellt DeepSeek V4 Flash über ein lokales Metal-Backend mit einer OpenAI-kompatiblen `/v1`-API bereit. OpenClaw verbindet sich mit ds4 über die generische Provider-Familie `openai-completions`. ds4 ist kein gebündeltes OpenClaw-Provider-Plugin. Konfigurieren Sie es unter `models.providers.ds4` und wählen Sie dann `ds4/deepseek-v4-flash` aus. - Provider-ID: `ds4` - Plugin: keines - API: OpenAI-kompatible Chat Completions (`openai-completions`) - Vorgeschlagene Basis-URL: `http://127.0.0.1:18000/v1` - Modell-ID: `deepseek-v4-flash` - Tool-Aufrufe: unterstützt über OpenAI-ähnliche `tools` und `tool_calls` - Reasoning: DeepSeek-ähnliches `thinking` und `reasoning_effort` ## Anforderungen - macOS mit Metal-Unterstützung. - Ein funktionierender ds4-Checkout mit `ds4-server` und der DeepSeek V4 Flash-GGUF-Datei. - Ausreichend Arbeitsspeicher für den von Ihnen gewählten Kontext. Größere `--ctx`-Werte weisen beim Serverstart mehr KV-Speicher zu. OpenClaw-Agent-Turns enthalten Tool-Schemas und Workspace-Kontext. Ein sehr kleiner Kontext wie `--ctx 4096` kann direkte curl-Tests bestehen, aber vollständige Agent-Ausführungen mit `500 prompt exceeds context` fehlschlagen lassen. Verwenden Sie mindestens `--ctx 32768` für Agent- und Tool- Smoke-Tests. Verwenden Sie `--ctx 393216` nur, wenn Sie genügend Arbeitsspeicher haben und das ds4- Think-Max-Verhalten wünschen. ## Schnellstart Ersetzen Sie `` durch den Pfad zu Ihrem 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 ``` Die Antwort sollte `deepseek-v4-flash` enthalten. Fügen Sie die Konfiguration aus [Vollständige Konfiguration](#full-config) hinzu und führen Sie dann eine einmalige Modellprüfung aus: ```bash openclaw infer model run \ --local \ --model ds4/deepseek-v4-flash \ --thinking off \ --prompt "Reply with exactly: openclaw-ds4-ok" \ --json ``` ## Vollständige Konfiguration Verwenden Sie diese Konfiguration, wenn ds4 bereits auf `127.0.0.1:18000` läuft. ```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"], }, }, ], }, }, }, } ``` Halten Sie `contextWindow` mit dem Wert `ds4-server --ctx` synchron. Halten Sie `maxTokens` mit `--tokens` synchron, es sei denn, Sie möchten absichtlich, dass OpenClaw weniger Ausgabe anfordert als die Servervorgabe. ## Start bei Bedarf OpenClaw kann ds4 nur starten, wenn ein `ds4/...`-Modell ausgewählt ist. Fügen Sie `localService` demselben Provider-Eintrag hinzu: ```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` muss ein absoluter ausführbarer Pfad sein. Shell-Suche und `~`-Erweiterung werden nicht verwendet. Siehe [Lokale Modelldienste](/de/gateway/local-model-services) für jedes `localService`-Feld. ## Think Max ds4 wendet Think Max nur an, wenn beide Bedingungen erfüllt sind: - `ds4-server` startet mit `--ctx 393216` oder höher. - Die Anfrage verwendet `reasoning_effort: "max"` oder das entsprechende ds4-Effort-Feld. Wenn Sie diesen großen Kontext ausführen, aktualisieren Sie sowohl die Server-Flags als auch die OpenClaw-Modellmetadaten: ```json5 { contextWindow: 393216, maxTokens: 384000, compat: { supportsUsageInStreaming: true, supportsReasoningEffort: true, maxTokensField: "max_tokens", supportsStrictMode: false, thinkingFormat: "deepseek", supportedReasoningEfforts: ["low", "medium", "high", "xhigh", "max"], }, } ``` ## Testen Beginnen Sie mit einer direkten HTTP-Prüfung: ```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"}}' ``` Testen Sie dann das OpenClaw-Modell-Routing: ```bash openclaw infer model run \ --local \ --model ds4/deepseek-v4-flash \ --thinking off \ --prompt "Reply with exactly: openclaw-ds4-ok" \ --json ``` Verwenden Sie für einen vollständigen Agent- und Tool-Aufruf-Smoke-Test einen Kontext von mindestens 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 " \ --json \ --timeout 240 ``` Erwartetes Ergebnis: - `executionTrace.winnerProvider` ist `ds4` - `executionTrace.winnerModel` ist `deepseek-v4-flash` - `toolSummary.calls` ist mindestens `1` - `finalAssistantVisibleText` beginnt mit `tool-ok` ## Fehlerbehebung ds4 läuft nicht oder ist nicht an Host und Port in `baseUrl` gebunden. Starten Sie `ds4-server` und versuchen Sie es dann erneut: ```bash curl http://127.0.0.1:18000/v1/models ``` Das konfigurierte `--ctx` ist für den OpenClaw-Turn zu klein. Erhöhen Sie `ds4-server --ctx` und aktualisieren Sie dann `models.providers.ds4.models[].contextWindow` entsprechend. Vollständige Agent-Turns mit Tools benötigen deutlich mehr Kontext als eine direkte curl-Anfrage mit einer einzelnen Nachricht. ds4 verwendet Think Max nur, wenn `--ctx` mindestens `393216` beträgt und die Anfrage `reasoning_effort: "max"` anfordert. Kleinere Kontexte fallen auf hohes Reasoning zurück. ds4 hat eine kalte Metal-Residency- und Modell-Aufwärmphase. Verwenden Sie `localService.readyTimeoutMs: 300000`, wenn OpenClaw den Server bei Bedarf startet. ## Verwandt Starten Sie lokale Modellserver bei Bedarf vor Modellanfragen. Wählen und betreiben Sie lokale Modell-Backends. Konfigurieren Sie Provider-Refs, Authentifizierung und Failover. Natives DeepSeek-Provider-Verhalten und Thinking-Steuerungen.