Saltar al contenido principal
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.
PropiedadValor
ID de proveedords4
Pluginninguno (solo configuración)
APIChat Completions compatible con OpenAI (openai-completions)
URL basehttp://127.0.0.1:18000/v1 (sugerida)
ID de modelodeepseek-v4-flash
Llamadas a herramientastools / tool_calls al estilo OpenAI
Razonamientothinking 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

1

Iniciar ds4-server

Sustituye <DS4_DIR> por la ruta de tu copia de trabajo de ds4.
<DS4_DIR>/ds4-server \
  --model <DS4_DIR>/ds4flash.gguf \
  --host 127.0.0.1 \
  --port 18000 \
  --ctx 32768 \
  --tokens 128
2

Verificar el endpoint compatible con OpenAI

curl http://127.0.0.1:18000/v1/models
La respuesta debería incluir deepseek-v4-flash.
3

Agregar la configuración de proveedor de OpenClaw

Agrega la configuración de Configuración completa y luego ejecuta una comprobación de modelo de una sola ejecución:
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. 
{
  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: 
{
  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 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: 
{
  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: 
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): 
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: 
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

ds4 no se está ejecutando o no está vinculado al host/puerto de baseUrl. Inicia ds4-server y vuelve a intentarlo:
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

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 proveedor, autenticación y conmutación por error.

DeepSeek

Comportamiento nativo del proveedor DeepSeek y controles de pensamiento.