Anthropic

Anthropic développe la famille de model Claude. OpenClaw prend en charge deux méthodes d’authentification :

Clé API — accès direct à l’Anthropic API avec facturation à l’utilisation (anthropic/* models)
**PH:GLOSSARY:141:2b65cd25%% Claude — réutilisation d’une connexion existante à la CLI Claude sur le même hôte

Getting started

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

Obtenez votre clé API
Créez une clé API dans la console Anthropic.

Exécuter l'intégration

openclaw onboard
# choose: Anthropic API key

Ou passez la clé directement :

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

Vérifiez que le model est disponible
Fenêtre de terminal
```
openclaw models list --provider anthropic
```

Exemple de configuration

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

Idéal pour : réutiliser une connexion Claude CLI existante sans clé API distincte.

S'assurer que Claude CLI est installé et connecté
Vérifiez avec :
Fenêtre de terminal
```
claude --version
```
Exécuter l'onboarding
Fenêtre de terminal
```
openclaw onboard
# choose: Claude CLI
```
OpenClaw détecte et réutilise les identifiants Claude CLI existants.
Vérifier que le modèle est disponible
Fenêtre de terminal
```
openclaw models list --provider anthropic
```

Exemple de configuration

Préférez la référence de modèle canonique Anthropic plus une substitution d’exécution CLI :

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

Les références de modèle claude-cli/claude-opus-4-7 héritées fonctionnent toujours pour la compatibilité, mais la nouvelle configuration doit conserver la sélection du fournisseur/du modèle comme anthropic/* et placer le backend d’exécution dans la stratégie d’exécution du fournisseur/du modèle.

Valeurs par défaut de réflexion (Claude 4.6)

Les modèles Claude 4.6 utilisent par défaut la réflexion adaptive dans OpenClaw lorsqu’aucun niveau de réflexion explicite n’est défini.

Remplacez par message avec /think:<level> ou dans les paramètres du modèle :

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

Cache de prompt

OpenClaw prend en charge la fonctionnalité de cache de prompt de Anthropic pour l’authentification par clé API.

Valeur	Durée du cache	Description
`"short"` (par défaut)	5 minutes	Appliqué automatiquement pour l’authentification par clé API
`"long"`	1 heure	Cache étendu
`"none"`	Pas de cache	Désactiver le cache de prompt

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

Per-agent cache overrides

Utilisez les paramètres au niveau du modèle comme base, puis redéfinissez 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 :

agents.defaults.models["provider/model"].params
agents.list[].params (correspondance id, remplacement par clé)

Cela permet à un agent de conserver un cache à long terme tandis qu’un autre agent sur le même modèle désactive la mise en cache pour le trafic sporadique/faiblement réutilisé.

Bedrock Claude notes

Les modèles Claude d’Anthropic sur Bedrock (amazon-bedrock/*anthropic.claude*) acceptent le transfert cacheRetentionAnthropic lorsqu’ils sont configurés.
Les modèles Bedrock non-Anthropic sont forcés à cacheRetention: "none"API lors de l’exécution.
Les valeurs par défaut intelligentes de clé d’API amorcent également cacheRetention: "short" pour les références Claude-on-Bedrock lorsqu’aucune valeur explicite n’est définie.

Configuration avancée

Mode rapide

L’interrupteur partagé /fastAnthropicAPIOAuth d’OpenClaw prend en charge le trafic direct vers Anthropic (clé d’API et OAuth 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 (image et PDF)

Le plugin Anthropic inclus enregistre la compréhension d’images et de PDF. OpenClaw résout 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-7`OpenClawAnthropic
Entrée prise en charge	Images, documents PDF

Lorsqu’une image ou un PDF est joint à une conversation, OpenClaw achemine automatiquement celui-ci via le fournisseur de compréhension des médias d’Anthropic.

1M context window (beta)

La fenêtre de contexte de 1M d’Anthropic est en version bêta. Activez-la par modèle :

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

OpenClaw mappe ceci vers anthropic-beta: context-1m-2025-08-07 lors des requêtes.

params.context1m: true s’applique également au backend Claude CLI (claude-cli/*) pour les modèles Opus et Sonnet éligibles, étendant la fenêtre de contexte d’exécution pour ces sessions CLI pour correspondre au comportement de l’API directe.

Claude Opus 4.7 1M context

anthropic/claude-opus-4.7 et sa variante claude-cli disposent d’une fenêtre de contexte de 1M par défaut — aucun params.context1m: true nécessaire.

Dépannage

401 errors / token suddenly invalid

L’authentification par jeton Anthropic expire et peut être révoquée. Pour les nouvelles configurations, utilisez plutôt une clé d’Anthropic API.

No API key found for provider "anthropic"

L’authentification Anthropic est par 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 de la passerelle), puis vérifiez avec openclaw models status.

No credentials found for profile "anthropic:default"

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.

No available auth profile (all in cooldown)

Consultez openclaw models status --json pour auth.unusableProfiles. Les temps d’attente des limites de débit Anthropic peuvent être spécifiques au modèle, un modèle Anthropic voisin peut donc toujours être utilisable. Ajoutez un autre profil Anthropic ou attendez la fin du temps d’attente.

Connexes

Model selection

Choisir les fournisseurs, les références de modèles et le comportement de basculement.

CLI backends

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

Prompt caching

Fonctionnement du cache de prompt (prompt caching) entre les fournisseurs.

OAuth and auth

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