OpenClaw con DeepSeek: configuración, IDs de modelo y costes de API

OpenClaw accede a DeepSeek mediante un complemento de proveedor oficial que se instala por separado — openclaw plugins install @openclaw/deepseek-provider —, con el id de proveedor deepseek, la clave DEEPSEEK_API_KEY, una API compatible con OpenAI y la URL base https://api.deepseek.com sin /v1. Dos hechos determinan si la primera ejecución funciona. El catálogo activo de DeepSeek contiene dos ids, deepseek-flash y deepseek-v4-pro; los nombres deepseek-chat y deepseek-reasoner que utilizan los tutoriales antiguos dejaron de estar disponibles el 24 de julio de 2026. Además, la incorporación de OpenClaw establece deepseek/deepseek-v4-pro como valor predeterminado, que es precisamente el modelo cuya facturación actual no coincide entre las propias páginas de DeepSeek.

Una aclaración antes de la configuración, porque los resultados de búsqueda los mezclan. Otro OpenClaw en GitHub se describe como «a multiplatform C++ reimplementation of original Captain Claw (1997) platformer game»; nada de ese proyecto se aplica aquí. El agente es el proyecto de openclaw.ai, documentado en docs.openclaw.ai; enlace ese host, ya que documentation.openclaw.ai solo redirige a él.

Instálelo y configúrelo tal como lo documentan ambos proyectos

# 1. Install the provider plugin — DeepSeek support is not bundled.
openclaw plugins install @openclaw/deepseek-provider

# 2. Interactive: prompts for the key, sets deepseek/deepseek-v4-pro as default.
openclaw onboard --auth-choice deepseek-api-key

# 2b. Or scripted, with the flags OpenClaw documents for a headless install.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk

Con el complemento instalado, no debe proporcionar una URL base: el complemento publica su propio catálogo y su propio comportamiento de compatibilidad. Una configuración mínima incluye la clave y el modelo, en JSON5.

{
  env: { vars: { DEEPSEEK_API_KEY: "sk-..." } },
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-v4-pro" },
    },
  },
}

OpenClaw resuelve una clave de proveedor a partir de cuatro formatos de variables de entorno en un orden de prioridad documentado: OPENCLAW_LIVE_DEEPSEEK_KEY como una única sustitución activa con la máxima prioridad; después DEEPSEEK_API_KEYS como una lista separada por comas o punto y coma; luego DEEPSEEK_API_KEY como clave principal; y finalmente las entradas numeradas DEEPSEEK_API_KEY_* (Interfaz de control y claves, comprobado el 21 de septiembre de 2026). Settings y después Models en la interfaz de control permiten añadir o reemplazar claves sin editar el archivo, y el material de la clave permanece en el almacén de autenticación. La trampa en una instalación de servidor es el ámbito, no la ortografía: la propia página de OpenClaw advierte que, si Gateway se ejecuta como demonio mediante launchd o systemd, la clave debe ser visible para ese proceso, por ejemplo en ~/.openclaw/.env o mediante env.shellEnv.

Qué ids de modelo de DeepSeek siguen realmente activos

Las filas siguientes representan tres estados diferentes, no uno solo. La respuesta de ejemplo en la referencia list-models de DeepSeek muestra exactamente dos ids, deepseek-flash y deepseek-v4-pro, mientras que el catálogo incluido de OpenClaw todavía ofrece cuatro referencias.

Mantenga separadas las dos afirmaciones sobre la retirada, porque parecen contradictorias y no lo son. OpenClaw afirma que DeepSeek retiró deepseek-chat y deepseek-reasoner y que «esos identificadores de modelo ya no son accesibles». DeepSeek afirma por separado que «los nombres heredados deepseek-v4-flash y deepseek-v4-flash-vision-exp siguen aceptándose, pero los modelos correspondientes se han retirado». Son dos pares de nombres distintos y dos resultados diferentes. La página Models & Pricing de DeepSeek asigna a ambos ids activos una ventana de contexto de 1M y una salida máxima de 384K, y la tabla del catálogo de OpenClaw contiene el mismo par 1.000.000 / 384.000 en sus cuatro referencias.

El punto sin resolver. El anuncio del 10 de septiembre de 2026 de DeepSeek afirma «We're phasing out V4-Pro» y que «starting at 04:00 UTC on Sept 14, 2026, all deepseek-v4-pro requests will route to V4.1-Flash at V4.1-Flash rates». El registro de cambios de la misma versión afirma lo contrario: «in response to user demand, we have decided to continue providing API services for DeepSeek V4 Pro after September 14, 2026, with the billing method remaining unchanged». La página Models & Pricing todavía incluye V4 Pro con sus tarifas más altas y no contiene ningún aviso de retirada. Ambas fuentes se consultaron el 21 de septiembre de 2026, una semana después de la fecha en cuestión. Esta página no le dirá cuál le factura; confírmelo en su propia cuenta de DeepSeek antes de dejar activo el modelo predeterminado, y tenga en cuenta que el predeterminado es precisamente el modelo en disputa.

Cuánto cuestan los tokens y por qué la hora forma parte del precio

DeepSeek publica tarifas de hora punta y fuera de punta, y la tarifa fuera de punta es la mitad de la de hora punta. La ventana es estrecha: «peak hours are 01:00 - 04:00 and 06:00 - 10:00 UTC, Monday through Friday, excluding Chinese public holidays. All other hours are off-peak, including weekends and Chinese public holidays in full.» Siete horas laborables son de hora punta y todo lo demás no lo es, por lo que una estimación que suponga silenciosamente hora punta sobreestima una factura típica.

Leído en la página Models & Pricing de DeepSeek el 21 de septiembre de 2026. La fila de Flash está corroborada de forma independiente por la página del proveedor de OpenClaw, que indica «$0.30 per million input tokens, $1.20 per million output tokens, and $0.006 per million cached input tokens». Las filas de V4 Pro se basan únicamente en la página Models & Pricing y están sujetas a la contradicción anterior, por lo que deben tratarse como cifras citadas, no como definitivas.

La columna de caché es la que modifica la factura de un agente, y su proporción es inusual. Un acierto de caché en deepseek-flash cuesta $0.006 por millón frente a $0.30 por un fallo, aproximadamente una quincuagésima parte de la tarifa de fallo, muy por debajo de la proporción de una décima habitual en otros lugares; no traslade, por tanto, una suposición de otro proveedor. La guía de almacenamiento en caché de DeepSeek afirma que la función «is enabled by default for all users, without needing to modify their code», que un acierto requiere un prefijo completamente coincidente y que una caché sin uso se borra «usually within a few hours to a few days». Los aciertos y fallos aparecen en los campos de uso prompt_cache_hit_tokens y prompt_cache_miss_tokens. DeepSeek no publica ningún precio de escritura de caché y su tabla de precios no tiene una columna para ella; se trata de una tarifa publicada ausente, no de una afirmación de que las escrituras sean gratuitas.

Una sesión ilustrativa en deepseek-flash, con las tarifas publicadas por DeepSeek. Suponga una ejecución de OpenClaw que envía 600.000 tokens de entrada, de los cuales 450.000 coinciden con la caché del prefijo y 150.000 no, y recibe 40.000 tokens de salida. En hora punta, eso supone $0.045 más $0.0027 más $0.048, es decir, $0.096; la misma sesión fuera de punta cuesta $0.048. La misma ejecución sin ningún acierto de caché costaría $0.228 en hora punta. Son cálculos de tokens basados en los supuestos indicados, no costes medidos de una tarea ni un límite de gasto; la proporción de aciertos de su propia caché es la variable más importante, y la cifra de la aplicación de OpenClaw no la resolverá, porque OpenClaw afirma que sus costes locales son estimaciones y remite a la página de precios de DeepSeek como autoridad para la facturación.

La capacidad del modelo y la compatibilidad del cliente con herramientas son dos cuestiones distintas

Esta es la parte que una tabla de precios no puede indicar y la razón práctica para utilizar el complemento en lugar de una entrada de proveedor creada manualmente. Las sesiones de razonamiento de DeepSeek V4 requieren que los mensajes del asistente se reproduzcan desde un turno con razonamiento activado para incluir reasoning_content en las solicitudes posteriores. El complemento DeepSeek de OpenClaw rellena ese campo automáticamente, por lo que el uso de herramientas en varios turnos funciona «even when history came from another OpenAI-compatible provider (no native reasoning_content) or from a plain assistant message», sin necesidad de /new después de cambiar de proveedor durante la sesión. Cuando el razonamiento está desactivado, incluida la selección None de la interfaz, OpenClaw envía thinking: { type: "disabled" } y elimina los reasoning_content reproducidos del historial saliente. OpenClaw también asigna tanto /think xhigh como /think max al máximo reasoning_effort de DeepSeek.

Un proveedor personalizado genérico openai-completions dirigido a un endpoint compatible con DeepSeek no obtiene ese relleno automático ni ningún formato de razonamiento de DeepSeek, a menos que declare usted mismo el bloque de compatibilidad; la página ds4 de OpenClaw muestra la estructura, incluidos thinkingFormat: "deepseek" y supportsReasoningEffort. Esa diferencia suele explicar que un turno con herramientas funcione una vez y falle en el siguiente.

Hay dos límites del lado de DeepSeek que deben formar parte de la misma decisión. La llamada a herramientas en modo estricto se realiza en una URL base diferente, https://api.deepseek.com/beta, y requiere "strict": true en cada función, además de "additionalProperties": false; no es la URL a la que apunta el complemento de forma predeterminada. Y la guía de llamadas a herramientas de DeepSeek afirma que «the Chat Completion API does not support inserting tool calls mid-conversation but does support inserting system messages mid-conversation; to insert tool calls, use the Anthropic API or the Responses API instead»; es un límite del endpoint que utiliza el complemento de OpenClaw, con dos alternativas documentadas, no una limitación del modelo.

En cuanto a la compatibilidad del modelo, ambas fuentes coinciden. La columna FEATURES de la página Models & Pricing de DeepSeek marca Tool Calls, JSON Output, Responses API y Anthropic API como compatibles tanto con deepseek-flash como con deepseek-v4-pro, y los diferencia en cuanto a visión: compatible con deepseek-flash y no compatible con deepseek-v4-pro. OpenClaw afirma que el uso de herramientas en varios turnos funciona con sus cuatro referencias. Ninguna de las dos fuentes documenta llamadas paralelas a herramientas, por lo que esa cuestión sigue realmente abierta.

Verifique en tres pasos y después revise los fallos que vale la pena mencionar

Compruebe las capas en orden, porque cada una falla de forma diferente. Primero, el catálogo: openclaw models list --provider deepseek, o openclaw models list --all --provider deepseek para inspeccionar el catálogo estático del complemento sin un Gateway en ejecución; después openclaw models set deepseek/deepseek-flash si quiere el modelo no controvertido en lugar del predeterminado de incorporación. Segundo, un prompt corto sin streaming y después uno con streaming, que es donde un problema de autenticación o de URL base aparece con claridad. Tercero, y solo tercero, una llamada a una herramienta seguida de un segundo turno en la misma sesión; es el único paso que ejercita la reproducción de reasoning_content descrita arriba.

La fila del 404 merece su propia frase, porque es la que la documentación no puede explicar por usted. La tabla de códigos de error de DeepSeek enumera 400, 401, 402, 422, 429, 500 y 503, y no contiene 404; por tanto, un 404 aquí aporta información sobre su enrutamiento, no sobre DeepSeek. No está documentado ni se ha probado aquí qué devuelve DeepSeek para un id de modelo desconocido. La referencia de errores cubre los códigos de estado equivalentes en el propio endpoint de Kunavo.

Directo, mediante Gateway o local: qué ruta gana

Kunavo no ofrece ningún modelo de DeepSeek. Sus modelos de texto pertenecen a las familias Claude y OpenAI, por lo que no existe una ruta de Kunavo a un modelo de DeepSeek y esta página no ofrece ninguna. Lo que sí se transfiere es el mecanismo, que conviene conocer si la razón por la que está leyendo una página de configuración de DeepSeek es que quiere una sola clave para varias familias de modelos, no específicamente para DeepSeek.

Para la fila del Gateway, la configuración utiliza las mismas dos palancas. Declare models.providers.<id> con baseUrl, apiKey, api: "openai-completions" y un array models[] que incluya al menos cada id, o incorpórese al endpoint con --auth-choice custom-api-key, --custom-base-url y --custom-model-id. Las referencias de modelo siempre son provider/model, y el fallo silencioso consiste en asignar un modelo como alias en agents.defaults.models sin registrarlo en models.providers.<provider>.models[]; la referencia de proveedores personalizados de OpenClaw indica que el alias «neither restricts overrides nor registers a new runtime model by itself». La URL base de Kunavo para esa ruta es https://api.kunavo.com/v1, con exactamente un /v1; lo contrario de la convención de DeepSeek sin sufijo y la fuente más probable de un 404 cuando alguien copia el valor de una página en el campo de la otra.

Para hacerse una idea de la escala de esa alternativa, aquí tiene la misma forma de sesión supuesta — 600.000 tokens de entrada y 40.000 tokens de salida, sin suponer aciertos de caché — valorada con las tarifas vigentes del catálogo de Kunavo. Son modelos diferentes en un endpoint diferente, por lo que se trata de una comparación de forma y no de una comparación de coste para la misma tarea con las cifras de DeepSeek anteriores; la tarifa más barata publicada y el menor coste para completar una tarea son afirmaciones distintas, y solo su propia ejecución puede resolver la segunda.

Cálculo ilustrativo de tokens basado en los supuestos indicados, no coste medido de una tarea ni límite de factura. El importe del catálogo de Kunavo es un suelo de facturación, no un tope: cuando el proveedor ascendente informa de su cargo, la factura es el mayor entre el coste del catálogo y el coste ascendente multiplicado por el margen aplicable. Los cargos de caché y las herramientas externas quedan fuera de este ejemplo. La recarga mínima es $10 en crédito prepago: un mínimo de financiación, no una tarifa por tarea ni una suscripción. Consulte los detalles de facturación y la caché.

Si esa ruta adyacente es realmente la que quiere, empiece por la vista general de integraciones para configurar la URL base y la clave; después consulte la guía de inicio rápido para realizar una primera llamada y cree una cuenta de Kunavo cuando esté listo para financiar una clave. Considérelo una referencia de configuración publicada, no un resultado de compatibilidad: OpenClaw no se ha probado en tiempo de ejecución contra el endpoint de Kunavo. ¿Prefiere quedarse en OpenClaw y elegir un modelo? Precios de OpenClaw separa el software gratuito de la factura por uso, la mejor API para OpenClaw compara las rutas por tarea y la API compatible con OpenAI cubre las convenciones de URL base sobre las que esta página sigue advirtiendo.

Preguntas frecuentes

Todas las afirmaciones anteriores sobre OpenClaw y DeepSeek se leyeron en la documentación y los registros propios de esos proyectos el 21 de septiembre de 2026, comparándolas con OpenClaw v2026.9.5; para esta página se volvieron a consultar directamente la página del proveedor, la página de precios, el registro de cambios, el anuncio del 10 de septiembre, la referencia list-models, la tabla de códigos de error, la página de límites de velocidad y las reglas de proveedores personalizados. No se instaló, incorporó ni llamó nada: no se ejecutó OpenClaw, no se realizó ninguna solicitud a api.deepseek.com y no se hizo ninguna prueba en tiempo de ejecución contra Kunavo. Las tarifas de tokens de Kunavo proceden del catálogo activo, y todas las cifras en dólares son cálculos ilustrativos de tokens, no costes medidos.