Saltar al contenido principal
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

Instalar Plugin

Instala el Plugin oficial y luego reinicia Gateway:
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart

Primeros pasos

1

Obtén tu clave de API

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

Ejecuta la incorporación

openclaw onboard --auth-choice deepseek-api-key
Solicita tu clave de API y establece deepseek/deepseek-v4-flash como modelo predeterminado.
3

Verifica que los modelos estén disponibles

openclaw models list --provider deepseek
Para inspeccionar el catálogo estático del Plugin sin un Gateway en ejecución:
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 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

Ref. del modeloNombreEntradaContextoSalida máximaNotas
deepseek/deepseek-v4-flashDeepSeek V4 Flashtexto1,000,000384,000Modelo predeterminado; superficie V4 con capacidad de razonamiento
deepseek/deepseek-v4-proDeepSeek V4 Protexto1,000,000384,000Superficie V4 con capacidad de razonamiento
deepseek/deepseek-chatDeepSeek Chattexto131,0728,192Superficie DeepSeek V3.2 sin razonamiento
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 posteriores para que las sesiones de razonamiento 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; ambos se asignan a "max".

Razonamiento y herramientas

Las sesiones de razonamiento de DeepSeek V4 requieren que los mensajes de asistente reproducidos desde un turno con razonamiento habilitado incluyan reasoning_content en las solicitudes posteriores. El Plugin DeepSeek de OpenClaw rellena ese campo automáticamente, por lo que el uso normal de herramientas en varios turnos funciona en deepseek/deepseek-v4-flash y deepseek/deepseek-v4-pro, incluso cuando el historial proviene de otro proveedor compatible con OpenAI (sin reasoning_content nativo) o de un mensaje de asistente simple. No se requiere /new después de cambiar de proveedor a mitad de sesión. Cuando el razonamiento está deshabilitado (incluida la selección Ninguna de la UI), OpenClaw envía thinking: { type: "disabled" } y elimina el reasoning_content reproducido del historial saliente, manteniendo 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 para el modelo más potente cuando puedas aceptar mayor costo o latencia.

Pruebas en vivo

Para ejecutar solo las comprobaciones directas de modelos DeepSeek V4 desde el conjunto moderno de pruebas en vivo de modelos:
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 se completen y que los turnos posteriores de razonamiento/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

Selección de modelos

Elegir proveedores, refs. de modelos y comportamiento de conmutación por error.

Referencia de configuración

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