Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Anthropic développe la famille de modèles Claude. OpenClaw prend en charge deux modes d’authentification :
  • Clé API — accès direct à l’API Anthropic avec facturation à l’usage (modèles anthropic/*)
  • Claude CLI — réutilise une connexion Claude CLI existante sur le même hôte
Le personnel d’Anthropic nous a indiqué que l’utilisation de type OpenClaw avec Claude CLI est de nouveau autorisée ; OpenClaw considère donc la réutilisation de Claude CLI et l’utilisation de claude -p comme approuvées, sauf si Anthropic publie une nouvelle politique.Pour les hôtes Gateway de longue durée, les clés API Anthropic restent la voie de production la plus claire et la plus prévisible.Documentation publique actuelle d’Anthropic :

​
Bien démarrer

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’intégration

openclaw onboard
# choose: Anthropic API key
Ou transmettez la clé directement :
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: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

​
Valeurs par défaut de raisonnement (Claude 4.6)

Les modèles Claude 4.6 utilisent par défaut le raisonnement adaptive dans OpenClaw lorsqu’aucun niveau de raisonnement explicite n’est défini. Remplacez-le par message avec /think:<level> ou dans les paramètres du modèle : 
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}
Documentation Anthropic associée :

​
Mise en cache des prompts

OpenClaw prend en charge la fonctionnalité de mise en cache des prompts d’Anthropic pour l’authentification par clé API.
ValeurDurée du cacheDescription
"short" (défaut)5 minutesAppliqué automatiquement pour l’authentification par clé API
"long"1 heureCache étendu
"none"Aucune mise en cacheDésactive la mise en cache des prompts
{
  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 un trafic en rafales ou à faible réutilisation.
  • Les modèles Anthropic Claude sur Bedrock (amazon-bedrock/*anthropic.claude*) acceptent le transfert 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 pour clé API renseignent aussi cacheRetention: "short" pour les références 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 multimédias à 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-7
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 multimédia Anthropic.
La fenêtre de contexte 1M d’Anthropic est soumise à un accès bêta. Activez-la par modèle :
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}
OpenClaw mappe cela à anthropic-beta: context-1m-2025-08-07 sur les requêtes.params.context1m: true s’applique aussi au backend Claude CLI (claude-cli/*) pour les modèles Opus et Sonnet éligibles, en étendant la fenêtre de contexte d’exécution de ces sessions CLI afin de correspondre au comportement de l’API directe.
Nécessite un accès long contexte sur votre identifiant Anthropic. L’ancienne authentification par jeton (sk-ant-oat-*) est rejetée pour les requêtes de contexte 1M — OpenClaw consigne un avertissement et revient à la fenêtre de contexte standard.
anthropic/claude-opus-4.7 et sa variante claude-cli disposent par défaut d’une fenêtre de contexte 1M — 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 par agent : les nouveaux agents n’héritent pas des clés de l’agent principal. Relancez l’intégration 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’intégration, ou configurez une clé API pour ce chemin de profil.
Consultez openclaw models status --json pour auth.unusableProfiles. Les cooldowns de limite de débit Anthropic peuvent être limités à un modèle ; un modèle Anthropic voisin peut donc encore être utilisable. Ajoutez un autre profil Anthropic ou attendez la fin du cooldown.
Aide supplémentaire : Dépannage et FAQ.

​
Liens associés

Sélection de modèle

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

Backends CLI

Détails de configuration et d’exécution du backend Claude CLI.

Mise en cache des prompts

Fonctionnement de la mise en cache des prompts entre fournisseurs.

OAuth et authentification

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