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

Instale el plugin oficial y, a continuación, reinicie el Gateway:

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

Primeros pasos

  • Obtener la clave de API

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

  • Ejecutar la incorporación

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

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

  • Verificar 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 mediante scripts o sin interfaz gráfica, pase 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 compatible con razonamiento
    deepseek/deepseek-v4-pro DeepSeek V4 Pro texto 1,000,000 384,000 Interfaz V4 compatible con razonamiento
    deepseek/deepseek-chat DeepSeek Chat texto 1,000,000 384,000 Nombre de compatibilidad obsoleto para V4 Flash sin razonamiento
    deepseek/deepseek-reasoner DeepSeek Reasoner texto 1,000,000 384,000 Nombre de compatibilidad obsoleto para 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 cambiar esas tarifas; su página Modelos y precios es la fuente oficial 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 simple del asistente. No se requiere /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.

    Use deepseek/deepseek-v4-flash para la ruta rápida predeterminada. Use deepseek/deepseek-v4-pro para el modelo más potente cuando pueda 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 útil reproducida 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