Anthropic

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

Premiers pas

openclaw onboard# choose: Anthropic API key

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

openclaw models list --provider anthropic

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

claude --version

openclaw onboard# choose: Claude CLI

openclaw models list --provider anthropic

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

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" },        },      },    },  },}

Repli en cas de refus de sécurité (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.

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },  },}

{  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" } },    ],  },}

Configuration avancée

{  agents: {    defaults: {      models: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {},      },    },  },}

Dépannage

Connexe