​

Anthropic (Claude)

​

Option A : clé API Anthropic

​

Configuration via CLI

openclaw onboard
# choisir : clé API Anthropic

# ou en non interactif
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​

Extrait de configuration Anthropic

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

​

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

• Les modèles Anthropic Claude 4.6 utilisent par défaut la réflexion adaptive dans OpenClaw lorsqu’aucun niveau de réflexion explicite n’est défini.
• Vous pouvez remplacer cela par message (/think:<level>) ou dans les paramètres du modèle : agents.defaults.models["anthropic/<model>"].params.thinking.
• Documentation Anthropic connexe :
  • Réflexion adaptive
  • Réflexion étendue

​

Mode rapide (API Anthropic)

• /fast on est mappé vers service_tier: "auto"
• /fast off est mappé vers service_tier: "standard_only"
• Valeur par défaut dans la configuration :

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

• OpenClaw n’injecte des niveaux de service Anthropic que pour les requêtes directes vers api.anthropic.com. Si vous faites transiter anthropic/* via un proxy ou une passerelle, /fast laisse service_tier inchangé.
• Les paramètres explicites du modèle Anthropic serviceTier ou service_tier remplacent la valeur par défaut de /fast lorsque les deux sont définis.
• Anthropic signale le niveau effectif dans la réponse sous usage.service_tier. Sur les comptes sans capacité Priority Tier, service_tier: "auto" peut quand même se résoudre en standard.

​

Mise en cache des prompts (API Anthropic)

​

Configuration

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

​

Valeurs par défaut

​

Surcharges cacheRetention par agent

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // base pour la plupart des agents
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // surcharge pour cet agent uniquement
    ],
  },
}

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

​

Notes sur Bedrock Claude

• Les modèles Anthropic Claude sur Bedrock (amazon-bedrock/*anthropic.claude*) acceptent le passage direct 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 de la clé API Anthropic initialisent aussi cacheRetention: "short" pour les références de modèles Claude sur Bedrock lorsqu’aucune valeur explicite n’est définie.

​

Fenêtre de contexte de 1M (bêta Anthropic)

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

​

Backend Claude CLI

• Le personnel d’Anthropic nous a indiqué que cette utilisation est de nouveau autorisée.
• OpenClaw considère donc la réutilisation de Claude CLI et l’utilisation de claude -p comme autorisées pour cette intégration, sauf si Anthropic publie une nouvelle politique.
• Les clés API Anthropic restent la voie de production la plus claire pour les hôtes de passerelle toujours actifs et pour un contrôle explicite de la facturation côté serveur.
• Les détails de configuration et d’exécution sont dans /gateway/cli-backends.

​

Remarques

• La documentation publique Claude Code d’Anthropic documente toujours l’utilisation directe de la CLI telle que claude -p, et le personnel d’Anthropic nous a indiqué que l’utilisation de Claude CLI de style OpenClaw est de nouveau autorisée. Nous considérons cette indication comme établie à moins qu’Anthropic ne publie un nouveau changement de politique.
• Le setup-token Anthropic reste disponible dans OpenClaw comme chemin pris en charge d’authentification par jeton, mais OpenClaw préfère désormais la réutilisation de Claude CLI et claude -p lorsque c’est disponible.
• Les détails d’authentification + les règles de réutilisation se trouvent dans /concepts/oauth.

​

Dépannage

• L’authentification par jeton Anthropic peut expirer ou être révoquée.
• Pour une nouvelle configuration, migrez vers une clé API Anthropic.

• L’authentification 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.

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

• Vérifiez openclaw models status --json pour auth.unusableProfiles.
• Les délais de refroidissement de limitation de débit Anthropic peuvent être ciblés par modèle, donc un modèle Anthropic apparenté peut encore être utilisable même si le modèle actuel est en refroidissement.
• Ajoutez un autre profil Anthropic ou attendez la fin du délai.