English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Providers

ds4

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.

Inicio rápido

  • Iniciar ds4-server

    Sustituye <DS4_DIR> por la ruta de tu checkout de ds4.

    bash
    <DS4_DIR>/ds4-server \  --model <DS4_DIR>/ds4flash.gguf \  --host 127.0.0.1 \  --port 18000 \  --ctx 32768 \  --tokens 128

  • Verificar el endpoint compatible con OpenAI

    bash
    curl http://127.0.0.1:18000/v1/models

    La respuesta debe incluir deepseek-v4-flash.

  • Agregar la configuración del proveedor de OpenClaw

    Agrega la configuración de Configuración completa 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_DIR>/ds4-server",          args: [            "--model",            "<DS4_DIR>/ds4flash.gguf",            "--host",            "127.0.0.1",            "--port",            "18000",            "--ctx",            "32768",            "--tokens",            "128",          ],          cwd: "<DS4_DIR>",          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 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 <output>" \  --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

    curl /v1/models no puede conectarse

    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
    500 prompt exceeds context

    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.

    Think Max no se activa

    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.

    La primera solicitud es lenta

    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

    Servicios de modelos locales

    Inicia servidores de modelos locales bajo demanda antes de las solicitudes de modelo.
    Modelos locales

    Elige y opera backends de modelos locales.
    Proveedores de modelos

    Configura referencias de proveedores, autenticación y conmutación por error.
    DeepSeek

    Comportamiento del proveedor nativo de DeepSeek y controles de pensamiento.
    Was this useful?
    On this page

    On this page