DeepSeek

DeepSeek fournit des modèles IA puissants avec une API compatible OpenAIAPI.

Propriété	Valeur
Fournisseur	`deepseek`
Auth	`DEEPSEEK_API_KEY`
API	compatible OpenAI
URL de base	`https://api.deepseek.com`

Getting started

Obtenez votre clé API
Créez une clé API sur platform.deepseek.com.
Lancer l'onboarding
Fenêtre de terminal
```
openclaw onboard --auth-choice deepseek-api-key
```
Cela vous demandera votre clé API et définira deepseek/deepseek-v4-flash comme modèle par défaut.
Vérifier que les modèles sont disponibles
Fenêtre de terminal
```
openclaw models list --provider deepseek
```
Pour inspecter le catalogue statique intégré sans nécessiter de Gateway en cours d’exécution, utilisez :
Fenêtre de terminal
```
openclaw models list --all --provider deepseek
```

Configuration non interactive

Pour les installations scriptées ou sans tête, passez tous les indicateurs directement :

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

Catalogue intégré

Réf modèle	Nom	Entrée	Contexte	Sortie max	Notes
`deepseek/deepseek-v4-flash`	DeepSeek V4 Flash	text	1 000 000	384 000	Modèle par défaut ; surface compatible réflexion V4
`deepseek/deepseek-v4-pro`	DeepSeek V4 Pro	texte	1 000 000	384 000	Surface compatible réflexion V4
`deepseek/deepseek-chat`	DeepSeek Chat	texte	131 072	8 192	Surface non réflexion DeepSeek V3.2
`deepseek/deepseek-reasoner`	DeepSeek Reasoner	texte	131 072	65 536	Surface V3.2 activée pour le raisonnement

Réflexion et outils

Les sessions de réflexion DeepSeek V4 ont un contrat de relecture plus strict que la plupart des fournisseurs compatibles OpenAI : après qu’un tour activé pour la réflexion utilise des outils, DeepSeek s’attend à ce que les messages d’assistant relus à partir de ce tour incluent reasoning_content lors des demandes de suivi. OpenClaw gère cela en interne via le plugin DeepSeek, donc l’utilisation multi-tours normale des outils fonctionne avec deepseek/deepseek-v4-flash et deepseek/deepseek-v4-pro.

Si vous basculez une session existante d’un autre fournisseur compatible OpenAI vers un modèle DeepSeek V4, les tours d’appels d’outil de l’assistant plus anciens peuvent ne pas avoir de reasoning_content natif DeepSeek. OpenClaw remplit ce champ manquant sur les messages d’assistant relus pour les demandes de réflexion DeepSeek V4, afin que le fournisseur puisse accepter l’historique sans exiger /new.

Lorsque la réflexion est désactivée dans OpenClaw (y compris lors de la sélection None dans l’interface), OpenClaw envoie DeepSeek thinking: { type: "disabled" } et supprime les reasoning_content rejoués de l’historique sortant. Cela permet de maintenir les sessions avec réflexion désactivée sur le chemin DeepSeek sans réflexion.

Utilisez deepseek/deepseek-v4-flash pour le chemin rapide par défaut. Utilisez deepseek/deepseek-v4-pro lorsque vous souhaitez le model V4 plus puissant et que vous pouvez accepter un coût ou une latence plus élevés.

Test en direct

La suite de modèles en direct comprend DeepSeek V4 dans l’ensemble de modèles modernes. Pour n’exécuter que les vérifications du modèle direct 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

Cette vérification en direct vérifie que les deux modèles V4 peuvent terminer et que les tours de suivi de réflexion/outils préservent la charge utile de relecture requise par DeepSeek.

Exemple de configuration

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

Connexes

Sélection du modèle

Choisir les fournisseurs, les références de modèle et le comportement de basculement.

Référence de configuration

Référence complète de la configuration pour les agents, les modèles et les fournisseurs.