Anthropic (Claude)

Anthropic developpe la famille de modeles Claude et fournit un acces via une API. Dans OpenClaw, vous pouvez vous authentifier avec une cle API ou un setup-token.

Option A : Cle API Anthropic

Ideal pour : l’acces API standard et la facturation a l’usage. Creez votre cle API dans la console Anthropic.

Configuration via la CLI

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Extrait de configuration

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Mise en cache des prompts (API Anthropic)

OpenClaw prend en charge la fonctionnalite de mise en cache des prompts d’Anthropic. C’est uniquement via l’API ; l’authentification par abonnement ne respecte pas les parametres de cache.

Configuration

Utilisez le parametre cacheRetention dans la configuration de votre modele :

Valeur	Duree du cache	Description
`none`	Pas de cache	Desactiver la mise en cache des prompts
`short`	5 minutes	Valeur par defaut pour l’authentification par cle API
`long`	1 heure	Cache etendu (necessite le drapeau beta)

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

Valeurs par défaut

Lors de l’utilisation de l’authentification par cle API Anthropic, OpenClaw applique automatiquement cacheRetention: "short" (cache de 5 minutes) a tous les modeles Anthropic. Vous pouvez remplacer ce comportement en definissant explicitement cacheRetention dans votre configuration.

Parametre historique

L’ancien parametre cacheControlTtl est toujours pris en charge pour assurer la retrocompatibilite :

"5m" correspond a short
"1h" correspond a long

Nous recommandons de migrer vers le nouveau parametre cacheRetention. OpenClaw inclut le drapeau beta extended-cache-ttl-2025-04-11 pour les requetes API Anthropic ; conservez-le si vous surchargez les en-tetes du fournisseur (voir /gateway/configuration).

Option B : Setup-token Claude

Ideal pour : utiliser votre abonnement Claude.

Ou obtenir un setup-token

Les setup-tokens sont crees par la Claude Code CLI, et non par la console Anthropic. Vous pouvez l’executer sur n’importe quelle machine :

claude setup-token

Collez le token dans OpenClaw (assistant : Anthropic token (coller le setup-token)), ou executez-le sur l’hote de la passerelle :

openclaw models auth setup-token --provider anthropic

Si vous avez genere le token sur une autre machine, collez-le :

openclaw models auth paste-token --provider anthropic

Configuration via la CLI

# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token

Configuration du snippet (setup-token)

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

Remarques

Generez le setup-token avec claude setup-token et collez-le, ou executez openclaw models auth setup-token sur l’hote de la passerelle.
Si vous voyez « OAuth token refresh failed … » avec un abonnement Claude, re-authentifiez-vous avec un setup-token. Voir /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription.
Les details d’authentification et les regles de reutilisation sont decrits dans /concepts/oauth.

Problemes courants

Erreurs 401 / token soudainement invalide

L’authentification par abonnement Claude peut expirer ou etre revoquee. Re-executez claude setup-token et collez-le sur l’hote de la passerelle.
Si la connexion via la CLI Claude se trouve sur une autre machine, utilisez openclaw models auth paste-token --provider anthropic sur l’hote de la passerelle.

Aucune cle API trouvee pour le fournisseur « anthropic »

L’authentification est par agent. Les nouveaux agents n’heritent pas des cles de l’agent principal.
Relancez la prise en main pour cet agent, ou collez un setup-token / une cle API sur l’hote de la passerelle, puis verifiez avec openclaw models status.

Aucun identifiant trouve pour le profil anthropic:default

Executez openclaw models status pour voir quel profil d’authentification est actif.
Relancez la prise en main, ou collez un setup-token / une cle API pour ce profil.

Aucun profil d’authentification disponible (tous en cooldown/indisponibles)

Verifiez openclaw models status --json pour auth.unusableProfiles.
Ajoutez un autre profil Anthropic ou attendez la fin du cooldown.

Plus d’informations : /gateway/troubleshooting et /help/faq.

Aperçu

Concepts de modèles

Configuration

Fournisseurs

Anthropic

Anthropic (Claude)

Option A : Cle API Anthropic

Configuration via la CLI

Extrait de configuration

Mise en cache des prompts (API Anthropic)

Configuration

Valeurs par défaut

Parametre historique

Option B : Setup-token Claude

Ou obtenir un setup-token

Configuration via la CLI

Configuration du snippet (setup-token)

Remarques

Problemes courants

​Anthropic (Claude)

​Option A : Cle API Anthropic

​Configuration via la CLI

​Extrait de configuration

​Mise en cache des prompts (API Anthropic)

​Configuration

​Valeurs par défaut

​Parametre historique

​Option B : Setup-token Claude

​Ou obtenir un setup-token

​Configuration via la CLI

​Configuration du snippet (setup-token)

​Remarques

​Problemes courants

Anthropic (Claude)

Option A : Cle API Anthropic

Configuration via la CLI

Extrait de configuration

Mise en cache des prompts (API Anthropic)

Configuration

Valeurs par défaut

Parametre historique

Option B : Setup-token Claude

Ou obtenir un setup-token

Configuration via la CLI

Configuration du snippet (setup-token)

Remarques

Problemes courants