Passer au contenu principal
Anthropic développe la famille de modèles Claude. OpenClaw prend en charge deux méthodes 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
Le backend Claude CLI d’OpenClaw exécute le Claude Code CLI installé en mode d’impression non interactif. La documentation actuelle de Claude Code d’Anthropic décrit claude -p comme une utilisation Agent SDK/programmatique. La mise à jour de support d’Anthropic du 15 juin 2026 a suspendu le changement de facturation Agent SDK annoncé. Pour l’instant, Anthropic indique que l’utilisation de Claude Agent SDK, de claude -p et des applications tierces continue de consommer les limites d’utilisation d’un abonnement. Le crédit mensuel Agent SDK précédemment annoncé n’est pas disponible pendant qu’Anthropic révise ce plan.Claude Code interactif continue de consommer les limites du plan Claude connecté. L’authentification par clé API reste une facturation API directe à l’usage. Pour les hôtes Gateway de longue durée, l’automatisation partagée et des dépenses de production prévisibles, utilisez une clé API Anthropic.Consultez les articles de support actuels d’Anthropic avant de vous appuyer sur le comportement de facturation par abonnement :

​
Premiers pas

Idéal pour : l’accès API standard et la facturation à l’usage.
1

Obtenir votre clé API

Créez une clé API dans l’Anthropic Console.
2

Exécuter l’onboarding

openclaw onboard
# choose: Anthropic API key
Ou transmettez directement la clé :
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
3

Vérifier que le modèle est disponible

openclaw models list --provider anthropic

​
Exemple de configuration

{
  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },
}

​
Valeurs par défaut de raisonnement (Claude Fable 5, 4.8 et 4.6)

anthropic/claude-fable-5 utilise toujours le raisonnement adaptatif et a high comme effort par défaut. Comme Anthropic ne permet pas de désactiver le raisonnement pour ce modèle, /think off et /think minimal utilisent l’effort low. OpenClaw omet également les valeurs de température personnalisées pour les requêtes Fable 5. Claude Opus 4.8 garde le raisonnement désactivé par défaut dans OpenClaw. Lorsque vous activez explicitement le raisonnement adaptatif avec /think high|xhigh|max, OpenClaw envoie les valeurs d’effort Opus 4.8 d’Anthropic ; les modèles Claude 4.6 utilisent adaptive par défaut. Remplacez par message avec /think:<level> ou dans les paramètres de modèle : 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-8": {
          params: { thinking: "high" },
        },
      },
    },
  },
}
Documentation Anthropic connexe :

​
Repli en cas de refus de sécurité (Claude Fable 5)

Utiliser Claude Fable 5 implique aussi d’utiliser Claude Opus 4.8. Fable 5 est fourni avec des classificateurs de sécurité qui peuvent refuser une requête, et la récupération sanctionnée par Anthropic consiste à faire traiter ce tour par claude-opus-4-8. OpenClaw active cela automatiquement pour les requêtes directes par clé API ; certains tours Fable reçoivent donc une réponse et sont facturés comme Claude Opus 4.8. Si votre politique ou votre budget ne peut pas accepter les tours traités par Opus, ne sélectionnez pas anthropic/claude-fable-5.

​
Pourquoi cela existe

Les classificateurs Fable 5 renvoient stop_reason: "refusal" pour les requêtes dans des domaines restreints, et produisent aussi des faux positifs sur du travail adjacent bénin (outillage de sécurité, sciences de la vie, ou même demander au modèle de reproduire son raisonnement brut). Sans repli, le tour échoue avec une erreur alors qu’un autre modèle Claude pourrait le traiter sans problème — le propre message de refus d’Anthropic demande aux intégrateurs API de configurer un modèle de repli.

​
Fonctionnement

  1. Pour chaque requête directe par clé API vers anthropic/claude-fable-5, OpenClaw envoie l’activation du repli côté serveur d’Anthropic : l’en-tête bêta server-side-fallback-2026-06-01 plus fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8 est la seule cible de repli autorisée par Anthropic pour Fable 5.
  2. Seul un refus par classificateur de sécurité déclenche le repli. Les limites de débit, les surcharges et les erreurs serveur se comportent exactement comme avant et passent par le basculement de modèle normal d’OpenClaw.
  3. Le sauvetage se produit dans le même appel. Un refus avant toute sortie est invisible en dehors de la latence ; toute la réponse provient d’Opus 4.8. En cas de refus au milieu du flux, le texte partiel est conservé comme préfixe à partir duquel le modèle de repli continue, tandis que le raisonnement et les appels d’outils du modèle refusé sont supprimés conformément aux règles de relecture d’Anthropic (ils ne doivent pas être renvoyés ni exécutés).
  4. Si Claude Opus 4.8 refuse également, le tour expose le refus comme une erreur, exactement comme avant cette fonctionnalité.
Le repli se produit 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 repli — une clé API compatible Fable peut toujours servir Opus.

​
Observabilité et facturation

  • Un tour servi par repli enregistre un diagnostic provider_fallback sur le message de l’assistant indiquant fromModel et toModel, et le responseModel du message indique claude-opus-4-8.
  • Anthropic facture par tentative : un refus avant sortie est gratuit, et le sauvetage est facturé aux tarifs de Claude Opus 4.8 (actuellement la moitié des tarifs de Fable 5). L’estimation du coût par tour d’OpenClaw valorise les tours servis par repli aux tarifs Opus pour correspondre.
  • Un refus au milieu du flux facture en plus le partiel Fable déjà diffusé côté Anthropic ; cette portion est indiquée 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 authentification par clé API auprès de api.anthropic.com. Les requêtes OAuth (réutilisation d’abonnement Claude CLI), URL de base proxy, Bedrock, Vertex et Foundry restent inchangées et continuent d’exposer les refus comme des erreurs dans ces cas. Vérifié en direct : 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 replis, et la même invite via OpenClaw renvoie une réponse normale servie par Opus avec le diagnostic provider_fallback attaché. Consultez le guide des refus et du repli d’Anthropic pour 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.
ValeurDurée du cacheDescription
"short" (par défaut)5 minutesAppliqué automatiquement pour l’authentification par clé API
"long"1 heureCache étendu
"none"Pas de mise en cacheDésactiver la mise en cache des invites
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
Utilisez les paramètres au niveau du modèle comme base, puis remplacez des agents spécifiques 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 :
  1. agents.defaults.models["provider/model"].params
  2. agents.list[].params (id correspondant, remplace 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 le trafic en rafales ou peu réutilisé.
  • Les modèles Anthropic Claude sur Bedrock (amazon-bedrock/*anthropic.claude*) acceptent le transfert direct de cacheRetention lorsqu’il est configuré.
  • Les modèles Bedrock non Anthropic sont forcés à cacheRetention: "none" à l’exécution.
  • Les valeurs par défaut intelligentes avec clé API définissent aussi cacheRetention: "short" pour les refs Claude sur Bedrock lorsqu’aucune valeur explicite n’est définie.

​
Configuration avancée

Le bouton partagé /fast d’OpenClaw prend en charge le trafic Anthropic direct (clé API et OAuth vers api.anthropic.com).
CommandeCorrespond à
/fast onservice_tier: "auto"
/fast offservice_tier: "standard_only"
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}
  • Injecté uniquement pour les requêtes directes vers api.anthropic.com. Les routes proxy laissent service_tier inchangé.
  • Les paramètres explicites serviceTier ou service_tier remplacent /fast lorsque les deux sont définis.
  • Sur les comptes sans capacité Priority Tier, service_tier: "auto" peut se résoudre en standard.
Le Plugin Anthropic intégré enregistre la compréhension des images et des PDF. OpenClaw résout automatiquement les capacités média à partir de l’authentification Anthropic configurée — aucune configuration supplémentaire n’est nécessaire.
PropriétéValeur
Modèle par défautclaude-opus-4-8
Entrée prise en chargeImages, documents PDF
Lorsqu’une image ou un PDF est joint à une conversation, OpenClaw l’achemine automatiquement via le fournisseur de compréhension média Anthropic.
La fenêtre de contexte 1M d’Anthropic est disponible sur les modèles Claude 4.x compatibles GA, comme Opus 4.8, Opus 4.7, Opus 4.6 et Sonnet 4.6. OpenClaw dimensionne automatiquement ces modèles à 1M :
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {},
      },
    },
  },
}
Les anciennes configurations peuvent conserver params.context1m: true, mais OpenClaw n’envoie plus l’en-tête bêta retiré context-1m-2025-08-07. Les anciennes entrées de configuration anthropicBeta avec cette valeur sont ignorées lors de la résolution des en-têtes de requête, et les anciens modèles Claude non pris en charge conservent leur fenêtre de contexte normale.params.context1m: true s’applique également au backend Claude CLI (claude-cli/*) pour les modèles Opus et Sonnet éligibles compatibles GA, en préservant la fenêtre de contexte d’exécution pour ces sessions CLI afin qu’elle corresponde au comportement de l’API directe.
Nécessite l’accès au contexte long sur votre identifiant Anthropic. L’authentification par jeton OAuth/abonnement conserve ses en-têtes bêta Anthropic requis, mais OpenClaw supprime l’en-tête bêta 1M retiré s’il reste dans une ancienne configuration.
anthropic/claude-opus-4-8 et sa variante claude-cli disposent d’une fenêtre de contexte 1M par défaut — aucun params.context1m: true n’est nécessaire.

​
Dépannage

L’authentification par jeton Anthropic expire et peut être révoquée. Pour les nouvelles configurations, utilisez plutôt une clé API Anthropic.
L’authentification Anthropic est propre à chaque agent — les nouveaux agents n’héritent pas des clés de l’agent principal. Relancez l’onboarding pour cet agent (ou configurez une clé API sur l’hôte Gateway), puis vérifiez avec openclaw models status.
Exécutez openclaw models status pour voir quel profil d’authentification est actif. Relancez l’onboarding ou configurez une clé API pour ce chemin de profil.
Consultez openclaw models status --json pour auth.unusableProfiles. Les périodes de refroidissement liées aux limites de débit Anthropic peuvent être propres à un modèle, donc un modèle Anthropic voisin peut encore être utilisable. Ajoutez un autre profil Anthropic ou attendez la fin de la période de refroidissement.
Aide supplémentaire : Dépannage et FAQ.

​
Connexe

Sélection du modèle

Choisir les fournisseurs, les refs de modèles et le comportement de basculement.

Backends CLI

Configuration du backend Claude CLI et détails d’exécution.

Mise en cache des prompts

Fonctionnement de la mise en cache des prompts entre les fournisseurs.

OAuth et authentification

Détails d’authentification et règles de réutilisation des identifiants.