OpenClaw avec DeepSeek : configuration, identifiants de modèle et coûts d’API

OpenClaw accède à DeepSeek via un plugin fournisseur officiel installé séparément — openclaw plugins install @openclaw/deepseek-provider —, avec l’identifiant de fournisseur deepseek, la clé DEEPSEEK_API_KEY, une API compatible OpenAI et l’URL de base https://api.deepseek.com ne contenant aucun /v1. Deux faits déterminent la réussite de votre première exécution. Le catalogue actif de DeepSeek ne contient que deux identifiants, deepseek-flash et deepseek-v4-pro ; les noms deepseek-chat et deepseek-reasoner utilisés dans les anciens tutoriels ont été abandonnés le 24 juillet 2026. Par ailleurs, l’intégration d’OpenClaw définit deepseek/deepseek-v4-pro comme valeur par défaut, c’est-à-dire le seul modèle dont la facturation actuelle fait l’objet d’un désaccord entre les propres pages de DeepSeek.

Une clarification avant la configuration, car les résultats de recherche les mélangent. Un autre OpenClaw sur GitHub se décrit comme « une réimplémentation multiplateforme en C++ du jeu de plateformes original Captain Claw (1997) » ; rien de ce projet ne s’applique ici. L’agent est le projet disponible sur openclaw.ai, documenté sur docs.openclaw.ai — utilisez ce domaine dans les liens, car documentation.openclaw.ai ne fait que rediriger vers celui-ci.

Installez-le et configurez-le conformément à la documentation des deux projets

# 1. Install the provider plugin — DeepSeek support is not bundled.
openclaw plugins install @openclaw/deepseek-provider

# 2. Interactive: prompts for the key, sets deepseek/deepseek-v4-pro as default.
openclaw onboard --auth-choice deepseek-api-key

# 2b. Or scripted, with the flags OpenClaw documents for a headless install.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk

Une fois le plugin installé, vous n’indiquez pas d’URL de base : le plugin publie son propre catalogue et son propre comportement de compatibilité. Une configuration minimale comprend la clé et le modèle, au format JSON5.

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

OpenClaw résout une clé de fournisseur à partir de quatre formes de variables d’environnement selon un ordre de priorité documenté : OPENCLAW_LIVE_DEEPSEEK_KEY comme remplacement actif unique de priorité maximale, puis DEEPSEEK_API_KEYS comme liste séparée par des virgules ou des points-virgules, puis DEEPSEEK_API_KEY comme clé principale, puis les entrées numérotées DEEPSEEK_API_KEY_* (Interface de contrôle et clés, vérifié le 21 septembre 2026). Dans l’interface de contrôle, Settings puis Models permet ensuite d’ajouter ou de remplacer des clés sans modifier le fichier, et les clés restent dans le magasin d’authentification. Pour une installation serveur, le piège tient à la portée plutôt qu’à l’orthographe : la propre page d’OpenClaw avertit que, si le Gateway s’exécute comme démon sous launchd ou systemd, la clé doit être visible par ce processus, par exemple dans ~/.openclaw/.env ou via env.shellEnv.

Quels identifiants de modèles DeepSeek sont réellement actifs ?

Les lignes ci-dessous présentent trois statuts différents, et non un seul. La réponse d’exemple de la référence list-models de DeepSeek montre exactement deux identifiants, deepseek-flash et deepseek-v4-pro, tandis que le catalogue intégré d’OpenClaw propose encore quatre références.

Conservez les deux déclarations de retrait séparées, car elles semblent contradictoires alors qu’elles ne le sont pas. OpenClaw indique que DeepSeek a retiré deepseek-chat et deepseek-reasoner et que « ces identifiants de modèle ne sont plus accessibles ». DeepSeek indique séparément que « les anciens noms deepseek-v4-flash et deepseek-v4-flash-vision-exp sont encore acceptés, mais que les modèles correspondants ont été retirés ». Deux paires de noms différentes, deux résultats différents. La page Models & Pricing de DeepSeek attribue aux deux identifiants actifs une fenêtre de contexte de 1M et une sortie maximale de 384K, et le tableau du catalogue d’OpenClaw affiche la même paire 1 000 000 / 384 000 pour ses quatre références.

Le point qui reste irrésolu. L’annonce du 10 septembre 2026 de DeepSeek indique : « Nous supprimons progressivement V4-Pro » et « à partir de 04:00 UTC le 14 septembre 2026, toutes les requêtes deepseek-v4-pro seront acheminées vers V4.1-Flash aux tarifs de V4.1-Flash ». Le journal des modifications de cette même version affirme l’inverse : « en réponse à la demande des utilisateurs, nous avons décidé de continuer à fournir des services API pour DeepSeek V4 Pro après le 14 septembre 2026, avec une méthode de facturation inchangée ». La page Models & Pricing répertorie encore V4 Pro avec ses propres tarifs plus élevés et ne contient aucun avis de retrait. Les deux pages ont été consultées le 21 septembre 2026, une semaine après la date concernée. Cette page ne vous indiquera pas lequel vous sera facturé : vérifiez-le dans votre propre compte DeepSeek avant de conserver la valeur par défaut de l’intégration, et notez que cette valeur par défaut correspond précisément au modèle contesté.

Quel est le coût des tokens, et pourquoi l’heure fait partie du prix

DeepSeek publie des tarifs de pointe et des tarifs hors pointe, ces derniers représentant la moitié des premiers. La fenêtre est étroite : « les heures de pointe sont de 01:00 à 04:00 et de 06:00 à 10:00 UTC, du lundi au vendredi, hors jours fériés chinois. Toutes les autres heures sont hors pointe, y compris les week-ends et l’intégralité des jours fériés chinois ». Sept heures par jour en semaine sont donc des heures de pointe, et toutes les autres ne le sont pas ; une estimation qui suppose silencieusement les heures de pointe surestime une facture typique.

Consulté sur la page Models & Pricing de DeepSeek le 21 septembre 2026. La ligne Flash est corroborée indépendamment par la page du fournisseur OpenClaw, qui indique « $0.30 par million de tokens d’entrée, $1.20 par million de tokens de sortie et $0.006 par million de tokens d’entrée mis en cache ». Les lignes V4 Pro reposent uniquement sur la page Models & Pricing et s’inscrivent dans la contradiction mentionnée ci-dessus ; considérez-les donc comme des tarifs cités, et non comme des tarifs définitivement établis.

La colonne du cache est celle qui modifie la facture d’un agent, et son ratio est inhabituel. Un accès au cache sur deepseek-flash coûte $0.006 par million, contre $0.30 en cas d’absence de cache — environ un cinquantième du tarif sans cache, bien en dessous du ratio d’un dixième courant ailleurs ; ne transposez donc pas une hypothèse provenant d’un autre fournisseur. Le guide de mise en cache de DeepSeek indique que cette fonctionnalité « est activée par défaut pour tous les utilisateurs, sans qu’il soit nécessaire de modifier leur code », qu’un accès au cache exige un préfixe parfaitement identique et qu’un cache inutilisé est supprimé « généralement en quelques heures à quelques jours ». Les accès et les absences d’accès au cache apparaissent dans les champs d’utilisation prompt_cache_hit_tokens et prompt_cache_miss_tokens. DeepSeek ne publie aucun tarif d’écriture du cache et son tableau tarifaire ne comporte aucune colonne correspondante ; il s’agit de l’absence d’un tarif publié, et non d’une affirmation selon laquelle les écritures seraient gratuites.

Une session illustrative avec deepseek-flash, aux tarifs publiés par DeepSeek. Supposons une exécution d’OpenClaw qui envoie 600 000 tokens d’entrée, dont 450 000 correspondent à un accès au cache de préfixe et 150 000 à une absence de cache, et qui reçoit 40 000 tokens de sortie. En période de pointe, cela représente $0.045 plus $0.0027 plus $0.048, soit $0.096 ; la même session hors pointe coûte $0.048. La même exécution sans aucun accès au cache coûterait $0.228 en période de pointe. Il s’agit de calculs de tokens fondés sur les hypothèses indiquées, et non de coûts de tâche mesurés ni d’un plafond de dépenses — la variable la plus importante est la proportion d’accès à votre propre cache, et le montant affiché dans l’application OpenClaw ne permettra pas de la déterminer, car OpenClaw précise que ses coûts locaux sont des estimations et renvoie à la page tarifaire de DeepSeek comme référence pour la facturation.

Les capacités du modèle et la prise en charge des outils par le client sont deux questions différentes

C’est le point qu’un tableau tarifaire ne peut pas vous indiquer, et la raison pratique d’utiliser le plugin plutôt qu’une entrée de fournisseur créée manuellement. Les sessions de réflexion DeepSeek V4 nécessitent que les messages assistant rejoués d’un tour avec réflexion activée transmettent reasoning_content dans les requêtes suivantes. Le plugin DeepSeek d’OpenClaw renseigne automatiquement ce champ, de sorte que l’utilisation d’outils sur plusieurs tours fonctionne « même lorsque l’historique provient d’un autre fournisseur compatible OpenAI (sans reasoning_content natif) ou d’un simple message assistant », sans nécessiter de /new après un changement de fournisseur au milieu de la session. Lorsque la réflexion est désactivée, y compris avec la sélection None de l’interface, OpenClaw envoie thinking: { type: "disabled" } et supprime les reasoning_content rejoués de l’historique sortant. OpenClaw associe également /think xhigh et /think max au niveau maximal reasoning_effort de DeepSeek.

Un fournisseur personnalisé générique openai-completions pointant vers un endpoint compatible DeepSeek ne bénéficie d’aucun de ces compléments automatiques et d’aucun format de réflexion DeepSeek, sauf si vous déclarez vous-même le bloc de compatibilité — la page ds4 d’OpenClaw en montre la structure, notamment thinkingFormat: "deepseek" et supportsReasoningEffort. Cette différence explique généralement qu’un tour avec outil réussisse une première fois, puis échoue au tour suivant.

Deux limites du côté de DeepSeek doivent entrer dans la même décision. L’appel d’outils en mode strict utilise une URL de base différente, https://api.deepseek.com/beta, et exige "strict": true pour chaque fonction ainsi que "additionalProperties": false ; ce n’est pas l’URL vers laquelle le plugin pointe par défaut. Par ailleurs, le guide d’appel d’outils de DeepSeek indique que « l’API Chat Completion ne prend pas en charge l’insertion d’appels d’outils au milieu d’une conversation, mais prend en charge l’insertion de messages system au milieu d’une conversation ; pour insérer des appels d’outils, utilisez plutôt l’API Anthropic ou l’API Responses » — une limite de l’endpoint utilisé par le plugin OpenClaw, avec deux alternatives documentées plutôt qu’une limitation du modèle.

Concernant la prise en charge par les modèles, les deux sources concordent. La colonne FEATURES de la page Models & Pricing de DeepSeek indique que les appels d’outils, la sortie JSON, l’API Responses et l’API Anthropic sont pris en charge par deepseek-flash et deepseek-v4-pro, et distingue la vision — prise en charge par deepseek-flash, mais pas par deepseek-v4-pro. OpenClaw indique que l’utilisation d’outils sur plusieurs tours fonctionne avec ses quatre références. Aucune des deux sources ne documente les appels d’outils parallèles ; ce point reste donc réellement ouvert, sans réponse dans un sens ou dans l’autre.

Vérifiez en trois étapes, puis examinez les échecs qui méritent d’être nommés

Vérifiez les différentes couches dans l’ordre, car chacune échoue différemment. Premièrement, le catalogue : openclaw models list --provider deepseek, ou openclaw models list --all --provider deepseek pour inspecter le catalogue statique du plugin sans Gateway en cours d’exécution, puis openclaw models set deepseek/deepseek-flash si vous voulez le modèle non contesté plutôt que la valeur par défaut de l’intégration. Deuxièmement, envoyez une courte invite sans streaming, puis une autre avec streaming ; c’est à ce stade qu’un problème d’authentification ou d’URL de base apparaît clairement. Troisièmement — et seulement troisièmement — effectuez un appel d’outil suivi d’un second tour dans la même session ; c’est la seule étape qui exerce la relecture de reasoning_content décrite ci-dessus.

La ligne consacrée au 404 mérite sa propre phrase, car c’est le point que la documentation ne peut pas expliquer à votre place. Le tableau des codes d’erreur de DeepSeek répertorie 400, 401, 402, 422, 429, 500 et 503, sans aucun 404 ; un 404 fournit donc ici des informations sur votre routage plutôt que sur DeepSeek. Le comportement réellement renvoyé par DeepSeek pour un identifiant de modèle inconnu n’est pas documenté et n’a pas été testé ici. La référence des erreurs couvre les codes d’état équivalents sur le propre endpoint de Kunavo.

Direct, gateway, local : quelle route l’emporte

Kunavo ne fournit aucun modèle DeepSeek. Ses modèles textuels appartiennent aux familles Claude et OpenAI ; il n’existe donc aucune route Kunavo vers un modèle DeepSeek et cette page n’en propose aucune. Ce qui reste transposable, c’est le mécanisme, ce qui mérite d’être su si la raison pour laquelle vous consultez une page de configuration DeepSeek est que vous voulez une seule clé pour plusieurs familles de modèles plutôt que DeepSeek en particulier.

Pour la ligne du gateway, la configuration repose sur les mêmes deux leviers. Déclarez soit models.providers.<id> avec baseUrl, apiKey, api: "openai-completions" et un tableau models[] répertoriant au moins chaque id, soit effectuez l’intégration auprès de l’endpoint avec --auth-choice custom-api-key, --custom-base-url et --custom-model-id. Les références de modèle sont toujours au format provider/model, et l’échec silencieux consiste à associer un modèle sous agents.defaults.models sans l’enregistrer dans models.providers.<provider>.models[] — la référence des fournisseurs personnalisés d’OpenClaw précise que l’alias « ne restreint pas les remplacements et n’enregistre pas à lui seul un nouveau modèle d’exécution ». L’URL de base de Kunavo pour cette route est https://api.kunavo.com/v1, avec exactement un /v1 — l’inverse de la convention de DeepSeek sans suffixe, et la source la plus probable d’un 404 lorsque quelqu’un copie la valeur d’une page dans le champ de l’autre.

Pour donner une idée de l’échelle de cette alternative, voici la même forme de session supposée — 600 000 tokens d’entrée et 40 000 tokens de sortie, sans cache supposé — chiffrée aux tarifs actuels du catalogue Kunavo. Il s’agit de modèles différents sur un endpoint différent ; c’est donc une comparaison de forme et non une comparaison du coût d’une même tâche avec les chiffres DeepSeek ci-dessus. Le tarif affiché le moins cher et le coût le plus bas pour terminer une tâche sont deux affirmations distinctes, et seule votre propre exécution permet d’établir la seconde.

Calcul illustratif de tokens fondé sur les hypothèses indiquées, et non coût de tâche mesuré ni plafond de facture. Le montant du catalogue Kunavo constitue un plancher de facturation plutôt qu’un plafond : lorsque l’amont communique ses frais, la facture correspond au montant le plus élevé entre le coût du catalogue et le coût amont multiplié par la majoration applicable. Les frais de cache et les outils externes ne sont pas inclus dans cet exemple. Le rechargement minimal est de $10 en crédit prépayé — un minimum de financement, et non des frais de tâche ni un abonnement. Consultez les détails de facturation et la mise en cache.

Si cette route adjacente est réellement celle que vous recherchez, commencez par la vue d’ensemble des intégrations pour l’URL de base et la configuration de la clé, puis consultez le guide de démarrage rapide pour un premier appel, et créez un compte Kunavo lorsque vous êtes prêt à approvisionner une clé. Considérez cela comme une référence de configuration publiée, et non comme un résultat de compatibilité : OpenClaw n’a pas été testé en conditions d’exécution avec l’endpoint de Kunavo. Vous restez sur OpenClaw et souhaitez plutôt choisir un modèle ? La page tarifs d’OpenClaw distingue le logiciel gratuit de la facture à l’usage, la page meilleure API pour OpenClaw compare les routes selon la tâche et la page API compatible OpenAI présente les conventions d’URL de base auxquelles cette page vous invite constamment à prêter attention.

Questions fréquentes

Toutes les affirmations concernant OpenClaw et DeepSeek ci-dessus ont été consultées dans la documentation et les registres propres à ces projets le 21 septembre 2026, avec OpenClaw v2026.9.5 ; la page du fournisseur, la page tarifaire, le journal des modifications, l’annonce du 10 septembre, la référence list-models, le tableau des codes d’erreur, la page des limites de débit et les règles relatives aux fournisseurs personnalisés ont chacune été récupérés directement pour cette page. Rien n’a été installé, intégré ou appelé : aucune exécution d’OpenClaw, aucune requête vers api.deepseek.com et aucun test d’exécution avec Kunavo. Les tarifs des tokens Kunavo proviennent du catalogue actif, et chaque montant en dollars correspond à un calcul illustratif de tokens plutôt qu’à un coût mesuré.