Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

DeepSeek proporciona potentes modelos de IA con una API compatible con OpenAI.
PropiedadValor
Proveedordeepseek
AutenticaciónDEEPSEEK_API_KEY
APIcompatible con OpenAI
URL basehttps://api.deepseek.com

Primeros pasos

1

Get your API key

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

Run onboarding

openclaw onboard --auth-choice deepseek-api-key
Esto solicitará tu clave de API y establecerá deepseek/deepseek-v4-flash como modelo predeterminado.
3

Verify models are available

openclaw models list --provider deepseek
Para inspeccionar el catálogo estático incluido sin requerir un Gateway en ejecución, usa:
openclaw models list --all --provider deepseek
Para instalaciones con scripts o sin interfaz, pasa todas las marcas directamente:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk
Si el Gateway se ejecuta como daemon (launchd/systemd), asegúrate de que DEEPSEEK_API_KEY esté disponible para ese proceso (por ejemplo, en ~/.openclaw/.env o mediante env.shellEnv).

Catálogo integrado

Referencia de modeloNombreEntradaContextoSalida máximaNotas
deepseek/deepseek-v4-flashDeepSeek V4 Flashtexto1,000,000384,000Modelo predeterminado; superficie V4 con capacidad de pensamiento
deepseek/deepseek-v4-proDeepSeek V4 Protexto1,000,000384,000Superficie V4 con capacidad de pensamiento
deepseek/deepseek-chatDeepSeek Chattexto131,0728,192Superficie DeepSeek V3.2 sin pensamiento
deepseek/deepseek-reasonerDeepSeek Reasonertexto131,07265,536Superficie V3.2 con razonamiento habilitado
Los modelos V4 admiten el control thinking de DeepSeek. OpenClaw también reproduce reasoning_content de DeepSeek en turnos de seguimiento para que las sesiones de pensamiento con llamadas a herramientas puedan continuar. Usa /think xhigh o /think max con modelos DeepSeek V4 para solicitar el reasoning_effort máximo de DeepSeek.

Pensamiento y herramientas

Las sesiones de pensamiento de DeepSeek V4 tienen un contrato de reproducción más estricto que la mayoría de los proveedores compatibles con OpenAI: después de que un turno con pensamiento habilitado usa herramientas, DeepSeek espera que los mensajes del asistente reproducidos de ese turno incluyan reasoning_content en las solicitudes de seguimiento. OpenClaw maneja esto dentro del Plugin de DeepSeek, por lo que el uso normal de herramientas de varios turnos funciona con deepseek/deepseek-v4-flash y deepseek/deepseek-v4-pro. Si cambias una sesión existente de otro proveedor compatible con OpenAI a un modelo DeepSeek V4, es posible que los turnos anteriores de llamadas a herramientas del asistente no tengan reasoning_content nativo de DeepSeek. OpenClaw completa ese campo faltante en los mensajes del asistente reproducidos para solicitudes de pensamiento de DeepSeek V4, de modo que el proveedor pueda aceptar el historial sin requerir /new. Cuando el pensamiento está deshabilitado en OpenClaw (incluida la selección None en la interfaz), OpenClaw envía a DeepSeek thinking: { type: "disabled" } y elimina el reasoning_content reproducido del historial saliente. Esto mantiene las sesiones con pensamiento deshabilitado en la ruta sin pensamiento de DeepSeek. Usa deepseek/deepseek-v4-flash para la ruta rápida predeterminada. Usa deepseek/deepseek-v4-pro cuando quieras el modelo V4 más potente y puedas aceptar mayor costo o latencia.

Pruebas en vivo

La suite directa de modelos en vivo incluye DeepSeek V4 en el conjunto de modelos moderno. Para ejecutar solo las comprobaciones de modelos directos de DeepSeek V4:
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
Esa comprobación en vivo verifica que ambos modelos V4 puedan completar solicitudes y que los turnos de seguimiento de pensamiento/herramientas conserven la carga de reproducción que DeepSeek requiere.

Ejemplo de configuración

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

Relacionado

Model selection

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

Configuration reference

Referencia completa de configuración para agentes, modelos y proveedores.