Providers
Anthropic
Anthropic développe la famille de modèles Claude. OpenClaw prend en charge deux modes d’authentification :
- Clé API - accès direct à l’API Anthropic avec facturation à l’usage (modèles
anthropic/*) - Claude CLI - réutilisation d’une connexion Claude Code existante sur le même hôte
Suivi de l’utilisation et des coûts
OpenClaw détecte l’identifiant Anthropic disponible et sélectionne l’interface d’utilisation correspondante :
- Les identifiants d’abonnement/de configuration Claude affichent les fenêtres de quota et le budget facultatif d’utilisation supplémentaire.
ANTHROPIC_ADMIN_KEYouANTHROPIC_ADMIN_API_KEYaffiche 30 jours de coûts d’organisation et d’utilisation de l’API Messages déclarés par le fournisseur dans Usage de l’interface de contrôle, notamment les dépenses quotidiennes, les totaux de jetons/cache, les principaux modèles et les catégories de coûts.- Un identifiant
sk-ant-admin...stocké dans le profil du fournisseur Anthropic est automatiquement détecté comme clé de l’API Admin.
L’historique des coûts de l’API Admin provient de l’API d’utilisation et de coûts d’Anthropic. Il correspond à la facturation réelle du fournisseur, distincte du coût estimé par OpenClaw à partir des sessions.
Prise en main
Clé API
Idéal pour : l’accès standard à l’API et la facturation à l’usage.
Obtenir votre clé API
Créez une clé API dans l’Anthropic Console.
Lancer la configuration initiale
openclaw onboard# choisir : Clé API AnthropicVous pouvez également transmettre directement la clé :
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"Vérifier que le modèle est disponible
openclaw models list --provider anthropicExemple de configuration
{ env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" }, agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}Claude CLI
Idéal pour : réutiliser une connexion Claude CLI existante sans clé API distincte.
Vérifier que Claude CLI est installé et connecté
Vérifiez avec :
claude --versionLancer la configuration initiale
openclaw onboard# choisir : Claude CLIOpenClaw détecte et réutilise les identifiants Claude CLI existants.
Vérifier que le modèle est disponible
openclaw models list --provider anthropicExemple de configuration
Préférez la référence canonique du modèle Anthropic avec une substitution du runtime CLI :
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" }, models: { "anthropic/claude-opus-4-8": { agentRuntime: { id: "claude-cli" }, }, }, }, },}Les anciennes références de modèle claude-cli/claude-opus-4-7
fonctionnent toujours pour assurer la compatibilité, mais les nouvelles
configurations doivent conserver la sélection du fournisseur/modèle sous
la forme anthropic/* et placer le backend d’exécution dans la politique
de runtime du fournisseur/modèle.
Facturation et claude -p
OpenClaw utilise le chemin non interactif claude -p de Claude Code pour
les exécutions Claude CLI. Anthropic traite actuellement ce chemin comme
une utilisation programmatique/de l’Agent SDK :
- La mise à jour de l’assistance d’Anthropic du 15 juin 2026 a suspendu le dispositif de crédit Agent SDK distinct précédemment annoncé.
- L’utilisation de Claude Agent SDK, de
claude -pet des applications tierces dans le cadre d’une offre avec abonnement continue d’être déduite des limites d’utilisation de l’abonnement connecté. - Le crédit mensuel Agent SDK précédemment annoncé n’est pas disponible pendant qu’Anthropic révise ce dispositif.
- Les connexions par Console/clé API utilisent la facturation de l’API à l’usage et ne bénéficient pas du crédit Agent SDK de l’abonnement.
Consultez l’article d’Anthropic sur l’offre Agent SDK pour l’avis de suspension, ainsi que les articles sur les offres Claude Code concernant le comportement des abonnements Pro/Max et Team/Enterprise.
Anthropic peut modifier la facturation et le comportement des limites de
débit de Claude Code sans nouvelle version d’OpenClaw. Consultez
claude auth status, /status et la documentation Anthropic liée lorsque
la prévisibilité de la facturation est importante.
Sessions Claude sur plusieurs ordinateurs
Le plugin Anthropic intégré ajoute un groupe Claude Code à la barre latérale habituelle des sessions. Les lignes s’ouvrent dans le volet de discussion habituel. Il détecte les sessions Claude Code non archivées sur le Gateway et sur les hôtes Node connectés :
- Les sessions Claude CLI proviennent d’enregistrements d’index de projet
valides et de fichiers JSONL actuels dont le préfixe borné de métadonnées
identifie une session
sdk-clihors chaîne secondaire sous~/.claude/projects/. - Les sessions Claude Desktop utilisent le titre du bureau, l’heure d’activité et l’état d’archivage lorsque leurs métadonnées pointent vers le même identifiant de session Claude Code.
- Une session limitée à la CLI ne possède aucun indicateur d’archivage ; elle reste donc visible tant que sa transcription est présente.
Aucune configuration OpenClaw supplémentaire n’est nécessaire. Le plugin
Anthropic est intégré et activé par défaut ; un Node macOS natif publie les
commandes Claude de session en lecture seule lorsque le répertoire local
~/.claude/projects/ existe. Approuvez la mise à niveau de l’association du
Node lorsque ces commandes apparaissent pour la première fois.
La barre latérale commence par la page bornée la plus récente de chaque hôte et
s’actualise selon la cadence habituelle de 30 secondes. Utilisez Charger plus
de sessions sous un groupe de catalogue pour ajouter la page suivante de
chaque hôte disposant d’un historique supplémentaire ; les lignes ajoutées
restent visibles et sont récupérées à nouveau jusqu’à la même profondeur lors
des actualisations. Les clients du catalogue utilisent
sessions.catalog.list ; l’ouverture d’une ligne utilise
sessions.catalog.read.
La sélection d’une ligne lit d’abord la page de transcription la plus récente. Charger des éléments de transcription plus anciens suit un curseur d’octets opaque et lit une autre section bornée du fichier JSONL au lieu de charger l’intégralité de l’historique. Le contenu normal de l’utilisateur, de l’assistant, du raisonnement, des appels d’outils et des résultats d’outils est conservé. Tout élément individuel dépassant le plafond de sécurité du Node/Gateway est clairement marqué comme tronqué.
Pour une ligne claude-cli locale au Gateway, la saisie dans le compositeur
habituel appelle sessions.catalog.continue. OpenClaw résout à nouveau
l’enregistrement local du catalogue, crée ou réutilise une session native
verrouillée sur le modèle, importe au maximum 200 éléments visibles ou 512 Kio,
et initialise la liaison Claude CLI. Le premier tour reprend avec
--fork-session ; Claude attribue un nouvel identifiant de session à la
bifurcation, de sorte que les tours suivants utilisent la bifurcation et que la
session source reste intacte. Les lignes Claude Desktop et celles des Nodes
associés sont en lecture seule.
Consultez Nodes : sessions et transcriptions Claude pour la commande du Node et la limite de sécurité.
Paramètres de réflexion par défaut (Claude Sonnet 5, Mythos 5, Fable 5, 4.8 et 4.6)
anthropic/claude-sonnet-5 utilise par défaut la réflexion adaptative avec un
effort high. Utilisez /think off pour désactiver la réflexion, ou
/think xhigh|max pour les niveaux d’effort natifs supérieurs du modèle.
OpenClaw omet les budgets de réflexion manuels, les paramètres
d’échantillonnage personnalisés, les préremplissages de l’assistant et Priority
Tier pour Sonnet 5, car Anthropic ne prend pas en charge ces fonctionnalités de
requête sur ce modèle.
Le catalogue utilise le tarif de lancement d’Anthropic de $2/$10 en
entrée/sortie jusqu’au 31 août 2026 ; le tarif standard de $3/$15 commence le
1er septembre 2026.
anthropic/claude-fable-5 utilise toujours la réflexion adaptative et applique
par défaut un effort high. Anthropic ne permet pas de désactiver la réflexion
pour ce modèle ; /think off et /think minimal correspondent donc à un effort
low. OpenClaw omet également les valeurs de température personnalisées pour
les requêtes Fable 5, car Anthropic rejette toute substitution de température
dans une requête où la réflexion est activée.
anthropic/claude-mythos-5 est un modèle à accès limité qui applique le même
contrat de réflexion adaptative toujours active. OpenClaw utilise high par
défaut, associe /think off et /think minimal à low, et omet les paramètres
d’échantillonnage sélectionnés par l’appelant.
Le catalogue indique sa fenêtre de contexte de 1 000 000 de jetons, sa limite
de sortie de 128 000 jetons, la prise en charge des images en entrée et son
tarif de $10/$50 en entrée/sortie.
Claude Opus 4.8 conserve la réflexion désactivée par défaut dans OpenClaw.
Lorsque vous activez explicitement la réflexion adaptative avec
/think high|xhigh|max, OpenClaw transmet les valeurs d’effort Opus 4.8
d’Anthropic ; les modèles Claude 4.6 (Opus 4.6 et Sonnet 4.6) utilisent
adaptive par défaut.
Remplacez ce réglage pour chaque message avec /think:<level> ou dans les
paramètres du modèle :
{ agents: { defaults: { models: { "anthropic/claude-opus-4-8": { params: { thinking: "high" }, }, }, }, },}Solution de repli en cas de refus de sécurité (Claude Fable 5)
Pourquoi cette fonctionnalité existe
Les classificateurs de Fable 5 renvoient stop_reason: "refusal" pour les requêtes
relevant de domaines restreints, et produisent également de faux positifs pour des
travaux bénins mais proches de ces domaines (outils de sécurité, sciences de la vie,
ou même demande au modèle de reproduire son raisonnement brut). Sans modèle de
secours, le tour se termine par une erreur, alors qu'un autre modèle Claude pourrait
parfaitement le traiter ; le message de refus d'Anthropic lui-même indique aux
intégrateurs d'API de configurer un modèle de secours.
Fonctionnement
- Pour chaque requête directe avec clé API vers
anthropic/claude-fable-5, OpenClaw envoie l'activation du mécanisme de secours côté serveur d'Anthropic : l'en-tête bêtaserver-side-fallback-2026-06-01ainsi quefallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 est la seule cible de secours qu'Anthropic autorise pour Fable 5. - Seul un refus du classificateur de sécurité déclenche le modèle de secours. Les limites de débit, les surcharges et les erreurs de serveur se comportent exactement comme auparavant et passent par le basculement de modèle normal d'OpenClaw.
- La récupération se produit au sein du même appel. Un refus avant toute sortie est invisible, hormis la latence ; l'intégralité de la réponse provient d'Opus 4.8. En cas de refus en cours de diffusion, le texte partiel est conservé comme préfixe à partir duquel le modèle de secours poursuit la réponse, tandis que le raisonnement et les appels d'outils du modèle ayant refusé sont éliminés conformément aux règles de relecture d'Anthropic (ils ne doivent être ni renvoyés ni exécutés).
- Si Claude Opus 4.8 refuse également, le refus est exposé comme une erreur, exactement comme avant cette fonctionnalité.
Le mécanisme de secours intervient au niveau de l'API Anthropic ; claude-opus-4-8
n'a donc pas besoin de figurer dans votre liste de modèles configurée ni dans votre
chaîne de secours : une clé API compatible avec Fable peut toujours servir Opus.
Observabilité et facturation
- Un tour traité par le modèle de secours enregistre un diagnostic
provider_fallbacksur le message de l'assistant, indiquantfromModelettoModel, et le champresponseModeldu message indiqueclaude-opus-4-8. - Anthropic facture chaque tentative : un refus avant toute sortie est gratuit, tandis que la récupération est facturée aux tarifs de Claude Opus 4.8 (actuellement la moitié de ceux de Fable 5). L'estimation du coût par tour d'OpenClaw applique les tarifs d'Opus aux tours traités par le modèle de secours afin de rester cohérente.
- Un refus en cours de diffusion entraîne également la facturation, par Anthropic, de la partie Fable déjà diffusée ; cette partie figure dans l'utilisation par tentative de l'API, mais n'est pas intégrée à l'estimation par tour d'OpenClaw.
Portée
S'applique à anthropic/claude-fable-5 avec une authentification par clé API auprès
de api.anthropic.com. Les requêtes OAuth (réutilisation d'un abonnement Claude CLI),
les URL de base de proxy, Bedrock, Vertex et Foundry restent inchangées et continuent
d'exposer les refus comme des erreurs.
Vérification en conditions réelles : une invite bénigne demandant à Fable 5 de
reproduire sa chaîne de pensée brute est refusée avec
category: "reasoning_extraction" lorsqu'elle est envoyée sans modèle de secours,
tandis que la même invite via OpenClaw renvoie une réponse normale traitée par Opus,
accompagnée du diagnostic provider_fallback.
Consultez le guide d'Anthropic sur les refus et les modèles de secours pour connaître le comportement sous-jacent.
Mise en cache des invites
OpenClaw prend en charge la fonctionnalité de mise en cache des invites d'Anthropic pour l'authentification par clé API.
| Valeur | Durée du cache | Description |
|---|---|---|
"short" (par défaut) |
5 minutes | Appliquée automatiquement à l'authentification par clé API |
"long" |
1 heure | Cache étendu |
"none" |
Aucun cache | Désactive la mise en cache des invites |
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, },}Remplacements du cache par agent
Utilisez les paramètres au niveau du modèle comme base, puis remplacez-les pour certains agents via agents.list[].params :
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" }, models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, list: [ { id: "research", default: true }, { id: "alerts", params: { cacheRetention: "none" } }, ], },}Ordre de fusion de la configuration :
agents.defaults.models["provider/model"].paramsagents.list[].params(idcorrespondant, remplacement par clé)
Cela permet à un agent de conserver un cache de longue durée, tandis qu'un autre agent utilisant le même modèle désactive la mise en cache pour un trafic en rafales ou à faible réutilisation.
Remarques sur Claude avec Bedrock
- Les modèles Anthropic Claude sur Bedrock (
amazon-bedrock/*anthropic.claude*) acceptent la transmission decacheRetentionlorsqu'elle est configurée. - Les modèles Bedrock autres que ceux d'Anthropic sont forcés à utiliser
cacheRetention: "none"lors de l'exécution. - Les valeurs par défaut intelligentes pour les clés API initialisent également
cacheRetention: "short"pour les références Claude sur Bedrock lorsqu'aucune valeur explicite n'est définie.
Configuration avancée
Mode rapide
Le commutateur partagé /fast d'OpenClaw définit le champ service_tier d'Anthropic pour le trafic direct avec clé API vers api.anthropic.com.
| Commande | Correspond à |
|---|---|
/fast on |
service_tier: "auto" |
/fast off |
service_tier: "standard_only" |
{ agents: { defaults: { models: { "anthropic/claude-sonnet-4-6": { params: { fastMode: true }, }, }, }, },}Compréhension des médias (images et PDF)
Le Plugin Anthropic fourni enregistre la compréhension des images et des PDF. OpenClaw détermine automatiquement les capacités multimédias à partir de l'authentification Anthropic configurée ; aucune configuration supplémentaire n'est nécessaire.
| Propriété | Valeur |
|---|---|
| Modèle par défaut | claude-opus-4-8 |
| Entrées prises en charge | Images, documents PDF |
Lorsqu'une image ou un PDF est joint à une conversation, OpenClaw l'achemine automatiquement par le fournisseur de compréhension multimédia d'Anthropic.
Fenêtre de contexte de 1M
Claude Sonnet 5, Mythos 5 et Fable 5 disposent d'une fenêtre d'entrée exacte de
1,000,000 jetons et prennent en charge jusqu'à 128,000 jetons de sortie. La fenêtre
de contexte de 1M d'Anthropic est également en disponibilité générale sur les modèles
Claude 4.x avec réflexion adaptative : Opus 4.8, Opus 4.7, Opus 4.6 et Sonnet 4.6.
OpenClaw dimensionne automatiquement ces modèles, sans nécessiter
params.context1m :
{ agents: { defaults: { models: { "anthropic/claude-sonnet-5": {}, "anthropic/claude-mythos-5": {}, "anthropic/claude-opus-4-6": {}, }, }, },}Les anciennes configurations peuvent conserver params.context1m: true ; il
s'agit d'une opération sans effet et sans conséquence pour ces modèles, et OpenClaw
n'envoie plus l'en-tête bêta retiré context-1m-2025-08-07, quelle que soit la
configuration. Les anciennes entrées de configuration anthropicBeta ayant cette
valeur sont supprimées lors de la résolution des en-têtes de requête, tandis que
les anciens modèles Claude non pris en charge conservent leur fenêtre de contexte
normale.
params.context1m: true se comporte de la même manière pour le backend Claude CLI
(claude-cli/*) : les modèles Opus et Sonnet admissibles et compatibles avec la
disponibilité générale bénéficient déjà automatiquement de la fenêtre de 1M ; ce
paramètre y est donc également facultatif.
Contexte de 1M de Claude Opus 4.8
anthropic/claude-opus-4-8 et sa variante claude-cli disposent par défaut d'une
fenêtre de contexte de 1M ; params.context1m: true n'est pas nécessaire.
Résolution des problèmes
Erreurs 401 / jeton soudainement invalide
L'authentification par jeton Anthropic expire et peut être révoquée. Pour les nouvelles configurations, utilisez plutôt une clé API Anthropic.
Aucune clé API trouvée pour le fournisseur "anthropic"
L'authentification Anthropic est propre à chaque agent ; les nouveaux agents n'héritent pas des clés de l'agent principal. Relancez l'intégration pour cet agent (ou configurez une clé API sur l'hôte du Gateway), puis vérifiez avec openclaw models status.
Aucun identifiant trouvé pour le profil "anthropic:default"
Exécutez openclaw models status pour voir quel profil d'authentification est actif. Relancez l'intégration ou configurez une clé API pour le chemin de ce profil.
Aucun profil d'authentification disponible (tous en période de récupération)
Consultez auth.unusableProfiles dans la sortie de openclaw models status --json. Les périodes de récupération dues aux limites de débit d'Anthropic peuvent être propres à un modèle ; un autre modèle Anthropic peut donc rester utilisable. Ajoutez un autre profil Anthropic ou attendez la fin de la période de récupération.
Ressources associées
Choix des fournisseurs, des références de modèles et du comportement de basculement.
Configuration du backend Claude CLI et détails d'exécution.
Fonctionnement de la mise en cache des invites entre les fournisseurs.
Détails de l'authentification et règles de réutilisation des identifiants.