Passer au contenu principal

​
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 :
ValeurDuree du cacheDescription
nonePas de cacheDesactiver la mise en cache des prompts
short5 minutesValeur par defaut pour l’authentification par cle API
long1 heureCache 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

​
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.