OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

DeepSeek

DeepSeek proporciona potentes modelos de IA con una API compatible con OpenAI.

Propiedad Valor
Proveedor deepseek
Autenticación DEEPSEEK_API_KEY
API Compatible con OpenAI
URL base https://api.deepseek.com

Instalar el plugin

Instala el plugin oficial y, a continuación, reinicia el Gateway:

bash
openclaw plugins install @openclaw/deepseek-provideropenclaw gateway restart

Primeros pasos

  • Obtén tu clave de API

    Crea una clave de API en platform.deepseek.com.

  • Ejecuta la incorporación

    bash
    openclaw onboard --auth-choice deepseek-api-key

    Solicita tu clave de API y establece deepseek/deepseek-v4-flash como modelo predeterminado.

  • Verifica que los modelos estén disponibles

    bash
    openclaw models list --provider deepseek

    Para inspeccionar el catálogo estático del plugin sin un Gateway en ejecución:

    bash
    openclaw models list --all --provider deepseek
    • Configuración no interactiva

    Para instalaciones automatizadas o sin interfaz gráfica, pasa todas las opciones directamente:

    bash
    openclaw onboard --non-interactive \  --mode local \  --auth-choice deepseek-api-key \  --deepseek-api-key "$DEEPSEEK_API_KEY" \  --skip-health \  --accept-risk

    Catálogo integrado

    Referencia del modelo Nombre Entrada Contexto Salida máxima Notas
    deepseek/deepseek-v4-flash DeepSeek V4 Flash texto 1,000,000 384,000 Modelo predeterminado; interfaz V4 con capacidad de razonamiento
    deepseek/deepseek-v4-pro DeepSeek V4 Pro texto 1,000,000 384,000 Interfaz V4 con capacidad de razonamiento
    deepseek/deepseek-chat DeepSeek Chat texto 1,000,000 384,000 Nombre de compatibilidad obsoleto de V4 Flash sin razonamiento
    deepseek/deepseek-reasoner DeepSeek Reasoner texto 1,000,000 384,000 Nombre de compatibilidad obsoleto de V4 Flash con razonamiento

    Las estimaciones de costes locales de OpenClaw siguen las tarifas publicadas por DeepSeek para aciertos de caché, fallos de caché y salida. DeepSeek puede modificar esas tarifas; su página Modelos y precios es la fuente autorizada para la facturación.

    Razonamiento y herramientas

    Las sesiones de razonamiento de DeepSeek V4 requieren que los mensajes reproducidos del asistente procedentes de un turno con razonamiento habilitado incluyan reasoning_content en las solicitudes posteriores. El plugin de DeepSeek para OpenClaw completa ese campo automáticamente, por lo que el uso normal de herramientas en varios turnos funciona con deepseek/deepseek-v4-flash y deepseek/deepseek-v4-pro, incluso cuando el historial procede de otro proveedor compatible con OpenAI (sin reasoning_content nativo) o de un mensaje normal del asistente. No es necesario usar /new después de cambiar de proveedor durante una sesión.

    Cuando el razonamiento está deshabilitado (incluida la selección None de la interfaz), OpenClaw envía thinking: { type: "disabled" } y elimina el reasoning_content reproducido del historial saliente, lo que mantiene la sesión en la ruta de DeepSeek sin razonamiento.

    Usa deepseek/deepseek-v4-flash como ruta rápida predeterminada. Usa deepseek/deepseek-v4-pro como modelo más potente cuando puedas aceptar un mayor coste o latencia.

    Pruebas en vivo

    Para ejecutar únicamente las comprobaciones directas de los modelos DeepSeek V4 de la suite moderna de pruebas en vivo de modelos:

    bash
    OPENCLAW_LIVE_PROVIDERS=deepseek \OPENCLAW_LIVE_MODELS="deepseek/deepseek-v4-flash,deepseek/deepseek-v4-pro" \pnpm test:live src/agents/models.profiles.live.test.ts

    Verifica que ambos modelos V4 completen la ejecución y que los turnos posteriores de razonamiento y uso de herramientas conserven la carga de reproducción que requiere DeepSeek.

    Ejemplo de configuración

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

    Contenido relacionado

    Selección de modelos

    Elección de proveedores, referencias de modelos y comportamiento de conmutación por error.
    Referencia de configuración

    Referencia completa de configuración para agentes, modelos y proveedores.
    Was this useful?
    On this page

    On this page