> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # ds4 [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 de proveedores genérica `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`. | Propiedad | Valor | | ----------------------- | ------------------------------------------------------------- | | ID de proveedor | `ds4` | | Plugin | ninguno (solo configuración) | | API | Chat Completions compatible con OpenAI (`openai-completions`) | | URL base | `http://127.0.0.1:18000/v1` (sugerida) | | ID de modelo | `deepseek-v4-flash` | | Llamadas a herramientas | `tools` / `tool_calls` al estilo OpenAI | | Razonamiento | `thinking` y `reasoning_effort` al estilo DeepSeek | ## Requisitos * macOS con soporte de Metal. * Una copia de trabajo de ds4 funcional con `ds4-server` y el archivo GGUF de DeepSeek V4 Flash. * Memoria suficiente para el contexto que elijas; los valores `--ctx` más grandes asignan más memoria KV al iniciar 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 con memoria suficiente y para habilitar ds4 Think Max. ## Inicio rápido Sustituye `` por la ruta de tu copia de trabajo de ds4. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} /ds4-server \ --model /ds4flash.gguf \ --host 127.0.0.1 \ --port 18000 \ --ctx 32768 \ --tokens 128 ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} curl http://127.0.0.1:18000/v1/models ``` La respuesta debería incluir `deepseek-v4-flash`. Agrega la configuración de [Configuración completa](#full-config) y luego ejecuta una comprobación de modelo de una sola ejecución: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 `ds4-server --ctx`. Mantén `maxTokens` alineado con `--tokens`, salvo que quieras intencionadamente 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 ver 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} { contextWindow: 393216, maxTokens: 384000, compat: { supportsUsageInStreaming: true, supportsReasoningEffort: true, maxTokensField: "max_tokens", supportsStrictMode: false, thinkingFormat: "deepseek", supportedReasoningEfforts: ["low", "medium", "high", "xhigh", "max"], }, } ``` ## Prueba Comprobación HTTP directa, sin pasar por OpenClaw: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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"}}' ``` Enrutamiento de modelo de OpenClaw (igual que la comprobación de Inicio rápido): ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw infer model run \ --local \ --model ds4/deepseek-v4-flash \ --thinking off \ --prompt "Reply with exactly: openclaw-ds4-ok" \ --json ``` Prueba de humo completa de agente y llamada a herramientas, con contexto de al menos 32768: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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á vinculado al host/puerto de `baseUrl`. Inicia `ds4-server` y vuelve a intentarlo: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 mucho más contexto que una solicitud directa de curl 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 Metal en frío y calentamiento del modelo. Define `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 proveedor, autenticación y conmutación por error. Comportamiento nativo del proveedor DeepSeek y controles de pensamiento.