--- read_when: - Quieres ejecutar OpenClaw contra antirez/ds4 - Quieres un backend local de DeepSeek V4 Flash con llamadas a herramientas - Necesitas la configuración de OpenClaw para ds4-server summary: Ejecuta OpenClaw mediante ds4, un servidor local compatible con OpenAI para DeepSeek V4 Flash title: ds4 x-i18n: generated_at: "2026-06-27T12:36:00Z" 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) sirve DeepSeek V4 Flash desde un backend Metal local con una API `/v1` compatible con OpenAI. OpenClaw se conecta a ds4 mediante la familia genérica de proveedores `openai-completions`. ds4 no es un Plugin de proveedor incluido con OpenClaw. Configúralo en `models.providers.ds4` y luego selecciona `ds4/deepseek-v4-flash`. - Id. del proveedor: `ds4` - Plugin: ninguno - API: Chat Completions compatible con OpenAI (`openai-completions`) - URL base sugerida: `http://127.0.0.1:18000/v1` - Id. del modelo: `deepseek-v4-flash` - Llamadas a herramientas: compatibles mediante `tools` y `tool_calls` al estilo de OpenAI - Razonamiento: `thinking` y `reasoning_effort` al estilo de DeepSeek ## Requisitos - macOS con compatibilidad con Metal. - Un checkout funcional de ds4 con `ds4-server` y el archivo GGUF de DeepSeek V4 Flash. - Memoria suficiente para el contexto que elijas. Los valores de `--ctx` más grandes asignan más memoria KV cuando se inicia el servidor. Los turnos de agente de OpenClaw incluyen esquemas de herramientas y contexto del espacio de trabajo. Un contexto pequeño como `--ctx 4096` puede superar pruebas directas con curl, pero fallar en ejecuciones completas de agente con `500 prompt exceeds context`. Usa al menos `--ctx 32768` para pruebas de humo de agentes y herramientas. Usa `--ctx 393216` solo cuando tengas suficiente memoria y quieras el comportamiento Think Max de ds4. ## Inicio rápido Sustituye `` por la ruta de tu checkout de ds4. ```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 ``` La respuesta debe incluir `deepseek-v4-flash`. Agrega la configuración de [Configuración completa](#full-config) y luego ejecuta una comprobación de modelo de un solo intento: ```bash openclaw infer model run \ --local \ --model ds4/deepseek-v4-flash \ --thinking off \ --prompt "Reply with exactly: openclaw-ds4-ok" \ --json ``` ## Configuración completa Usa esta configuración cuando ds4 ya se esté ejecutando en `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"], }, }, ], }, }, }, } ``` Mantén `contextWindow` alineado con el valor de `ds4-server --ctx`. Mantén `maxTokens` alineado con `--tokens`, salvo que quieras intencionalmente que OpenClaw solicite menos salida que el valor predeterminado del servidor. ## Inicio bajo demanda OpenClaw puede iniciar ds4 solo cuando se selecciona un modelo `ds4/...`. Agrega `localService` a la misma entrada de proveedor: ```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` debe ser una ruta absoluta a un ejecutable. No se usan la búsqueda del shell ni la expansión de `~`. Consulta [Servicios de modelos locales](/es/gateway/local-model-services) para todos los campos de `localService`. ## Think Max ds4 aplica Think Max solo cuando se cumplen ambas condiciones: - `ds4-server` se inicia con `--ctx 393216` o superior. - La solicitud usa `reasoning_effort: "max"` o el campo de esfuerzo equivalente de ds4. Si ejecutas ese contexto grande, actualiza tanto las marcas del servidor como los metadatos del modelo de OpenClaw: ```json5 { contextWindow: 393216, maxTokens: 384000, compat: { supportsUsageInStreaming: true, supportsReasoningEffort: true, maxTokensField: "max_tokens", supportsStrictMode: false, thinkingFormat: "deepseek", supportedReasoningEfforts: ["low", "medium", "high", "xhigh", "max"], }, } ``` ## Prueba Empieza con una comprobación HTTP directa: ```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"}}' ``` Luego prueba el enrutamiento de modelos de OpenClaw: ```bash openclaw infer model run \ --local \ --model ds4/deepseek-v4-flash \ --thinking off \ --prompt "Reply with exactly: openclaw-ds4-ok" \ --json ``` Para una prueba de humo completa de agente y llamada a herramientas, usa un contexto de al menos 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 ``` Resultado esperado: - `executionTrace.winnerProvider` es `ds4` - `executionTrace.winnerModel` es `deepseek-v4-flash` - `toolSummary.calls` es al menos `1` - `finalAssistantVisibleText` empieza con `tool-ok` ## Solución de problemas ds4 no se está ejecutando o no está enlazado al host y puerto de `baseUrl`. Inicia `ds4-server` y vuelve a intentarlo: ```bash curl http://127.0.0.1:18000/v1/models ``` El `--ctx` configurado es demasiado pequeño para el turno de OpenClaw. Aumenta `ds4-server --ctx` y luego actualiza `models.providers.ds4.models[].contextWindow` para que coincida. Los turnos completos de agente con herramientas necesitan bastante más contexto que una solicitud curl directa de un solo mensaje. ds4 solo usa Think Max cuando `--ctx` es al menos `393216` y la solicitud pide `reasoning_effort: "max"`. Los contextos más pequeños vuelven a razonamiento alto. ds4 tiene una fase de residencia en Metal en frío y calentamiento del modelo. Usa `localService.readyTimeoutMs: 300000` cuando OpenClaw inicia el servidor bajo demanda. ## Relacionado Inicia servidores de modelos locales bajo demanda antes de las solicitudes de modelo. Elige y opera backends de modelos locales. Configura referencias de proveedores, autenticación y conmutación por error. Comportamiento del proveedor nativo de DeepSeek y controles de pensamiento.