​

Anthropic (Claude)

​

Option A : clé API Anthropic

​

Configuration CLI

openclaw onboard
# choisir : clé API Anthropic

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

​

Extrait de configuration Claude CLI

{
  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 associée :
  • Adaptive thinking
  • Extended thinking

​

Mode rapide (API Anthropic)

• /fast on correspond à service_tier: "auto"
• /fast off correspond à service_tier: "standard_only"
• Valeur par défaut de configuration :

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

• OpenClaw n’injecte les niveaux de service Anthropic que pour les requêtes directes vers api.anthropic.com. Si vous routez anthropic/* via un proxy ou une passerelle, /fast laisse service_tier inchangé.
• Les paramètres explicites de modèle Anthropic serviceTier ou service_tier remplacent la valeur par défaut /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

​

Remplacements 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" } }, // remplacement pour cet agent uniquement
    ],
  },
}

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

​

Remarques 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 intelligentes par défaut pour les clés API Anthropic initialisent également cacheRetention: "short" pour les références de modèles Claude-on-Bedrock lorsqu’aucune valeur explicite n’est définie.

​

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

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

​

Option B : Claude CLI comme fournisseur de messages

• claude-cli/claude-sonnet-4-6
• claude-cli/claude-opus-4-6

1. OpenClaw lance claude -p --output-format stream-json --include-partial-messages ... sur l’hôte de la passerelle et envoie le prompt sur stdin.
2. Le premier tour envoie --session-id <uuid>.
3. Les tours suivants réutilisent la session Claude stockée via --resume <sessionId>.
4. Vos messages de chat passent toujours par le pipeline de messages OpenClaw normal, mais la réponse réelle du modèle est produite par Claude CLI.

​

Exigences

• Claude CLI installé sur l’hôte de la passerelle et disponible dans le PATH, ou configuré avec un chemin de commande absolu.
• Claude CLI déjà authentifié sur ce même hôte :

claude auth status

• OpenClaw charge automatiquement le plugin Anthropic intégré au démarrage de la passerelle lorsque votre configuration référence explicitement claude-cli/... ou une config de backend claude-cli.

​

Extrait de configuration

{
  agents: {
    defaults: {
      model: {
        primary: "claude-cli/claude-sonnet-4-6",
      },
      models: {
        "claude-cli/claude-sonnet-4-6": {},
      },
      sandbox: { mode: "off" },
    },
  },
}

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
      },
    },
  },
}

​

Ce que vous obtenez

• Réutilisation de l’authentification par abonnement Claude depuis la CLI locale (lue à l’exécution, non persistée)
• Routage normal des messages/sessions OpenClaw
• Continuité de session Claude CLI entre les tours (invalidée lors des changements d’auth)
• Outils de passerelle exposés à Claude CLI via un bridge MCP loopback
• Streaming JSONL avec progression en direct des messages partiels

​

Migrer de l’auth Anthropic vers Claude CLI

• Claude CLI installé sur le même hôte de passerelle qui exécute OpenClaw
• Claude CLI déjà connecté à cet endroit : claude auth login

openclaw models auth login --provider anthropic --method cli --set-default

openclaw onboard --auth-choice anthropic-cli

• vérifie que Claude CLI est déjà connecté sur l’hôte de la passerelle
• bascule le modèle par défaut vers claude-cli/...
• réécrit les solutions de repli de modèle par défaut Anthropic comme anthropic/claude-opus-4-6 en claude-cli/claude-opus-4-6
• ajoute des entrées claude-cli/... correspondantes à agents.defaults.models

openclaw models status

• supprimer vos profils d’authentification Anthropic existants
• supprimer toutes les anciennes références de configuration anthropic/... en dehors du chemin principal modèle/allowlist par défaut

​

Limites importantes

• Ce n’est pas le fournisseur API Anthropic. C’est le runtime CLI local.
• OpenClaw n’injecte pas directement les appels d’outils. Claude CLI reçoit les outils de passerelle via un bridge MCP loopback (bundleMcp: true, valeur par défaut).
• Claude CLI streame les réponses via JSONL (stream-json avec --include-partial-messages). Les prompts sont envoyés sur stdin, pas argv.
• L’authentification est lue à l’exécution depuis les identifiants Claude CLI en direct et n’est pas persistée dans les profils OpenClaw. Les invites Keychain sont supprimées dans les contextes non interactifs.
• La réutilisation de session est suivie via les métadonnées cliSessionBinding. Lorsque l’état de connexion Claude CLI change (reconnexion, rotation de jeton), les sessions stockées sont invalidées et une nouvelle session démarre.
• Convient surtout à un hôte de passerelle personnel, pas à des configurations de facturation partagée multi-utilisateurs.

​

Remarques

• La documentation publique Claude Code d’Anthropic documente toujours l’utilisation directe de la CLI telle que claude -p. Nous pensons que le mode de secours local géré par l’utilisateur est probablement autorisé, mais l’avis séparé d’Anthropic aux utilisateurs d’OpenClaw indique que le chemin Claude-login OpenClaw est un usage de harnais tiers et nécessite Extra Usage (paiement à l’usage facturé séparément de l’abonnement). Pour la production, nous recommandons plutôt les clés API Anthropic.
• Le jeton de configuration Anthropic est de nouveau disponible dans OpenClaw comme voie historique/manuelle. L’avis de facturation spécifique à OpenClaw d’Anthropic s’applique toujours, utilisez-le donc en partant du principe qu’Anthropic exige Extra Usage pour cette voie.
• Les détails d’authentification + règles de réutilisation se trouvent dans /concepts/oauth.

​

Dépannage

• L’authentification par jeton Anthropic historique peut expirer ou être révoquée.
• Pour une nouvelle configuration, migrez vers une clé API Anthropic ou vers le chemin local Claude CLI sur l’hôte de la passerelle.

• L’authentification est par agent. Les nouveaux agents n’héritent pas des clés de l’agent principal.
• Relancez l’intégration guidée 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’intégration guidée, ou configurez une clé API ou Claude CLI pour ce chemin de profil.

• Vérifiez openclaw models status --json pour auth.unusableProfiles.
• Les périodes de refroidissement de limitation de débit Anthropic peuvent être limitées à un modèle, donc un modèle Anthropic voisin peut encore être utilisable même lorsque le modèle actuel est en refroidissement.
• Ajoutez un autre profil Anthropic ou attendez la fin du refroidissement.