Providers

Amazon Bedrock

OpenClaw peut utiliser les modèles Amazon Bedrock via son fournisseur de streaming Bedrock Converse. L’authentification Bedrock utilise la chaîne d’identifiants par défaut du SDK AWS, et non une clé d’API.

Propriété Valeur
Fournisseur amazon-bedrock
API bedrock-converse-stream
Authentification Identifiants AWS (variables d’environnement, configuration partagée ou rôle d’instance)
Région AWS_REGION ou AWS_DEFAULT_REGION (par défaut : us-east-1)

Prise en main

Choisissez votre méthode d’authentification préférée et suivez les étapes de configuration.

Clés d’accès / variables d’environnement

Idéal pour : les machines de développement, la CI ou les hôtes sur lesquels vous gérez directement les identifiants AWS.

  • Définir les identifiants AWS sur l’hôte du Gateway

    bash
    export AWS_ACCESS_KEY_ID="EXAMPLE_AWS_ACCESS_KEY_ID"export AWS_SECRET_ACCESS_KEY="..."export AWS_REGION="us-east-1"# Facultatif :export AWS_SESSION_TOKEN="..."export AWS_PROFILE="your-profile"# Facultatif (clé d’API/jeton porteur Bedrock) :export AWS_BEARER_TOKEN_BEDROCK="..."
  • Ajouter un fournisseur et un modèle Bedrock à votre configuration

    Aucun apiKey n’est requis. Configurez le fournisseur avec auth: "aws-sdk" :

    json5
    {  models: {    providers: {      "amazon-bedrock": {        baseUrl: "https://bedrock-runtime.us-east-1.amazonaws.com",        api: "bedrock-converse-stream",        auth: "aws-sdk",        models: [          {            id: "us.anthropic.claude-opus-4-6-v1:0",            name: "Claude Opus 4.6 (Bedrock)",            reasoning: true,            input: ["text", "image"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 200000,            maxTokens: 8192,          },        ],      },    },  },  agents: {    defaults: {      model: { primary: "amazon-bedrock/us.anthropic.claude-opus-4-6-v1:0" },    },  },}
  • Vérifier que les modèles sont disponibles

    bash
    openclaw models list
  • Rôles d’instance EC2 (IMDS)

    Idéal pour : les instances EC2 auxquelles un rôle IAM est associé et qui utilisent le service de métadonnées d’instance pour l’authentification.

  • Activer explicitement la découverte

    Lorsque vous utilisez IMDS, OpenClaw ne peut pas détecter l’authentification AWS uniquement à partir des marqueurs d’environnement ; vous devez donc l’activer explicitement :

    bash
    openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1
  • Ajouter éventuellement un marqueur d’environnement pour le mode automatique

    Si vous souhaitez également que la détection automatique par marqueur d’environnement fonctionne, par exemple dans les interfaces de openclaw status :

    bash
    export AWS_PROFILE=defaultexport AWS_REGION=us-east-1

    Vous n’avez pas besoin d’une fausse clé d’API.

  • Vérifier que les modèles sont découverts

    bash
    openclaw models list
  • Découverte automatique des modèles

    OpenClaw peut découvrir automatiquement les modèles Bedrock prenant en charge le streaming et la sortie de texte. La découverte utilise bedrock:ListFoundationModels et bedrock:ListInferenceProfiles, et les résultats sont mis en cache (par défaut : 1 heure).

    Méthode d’activation du fournisseur implicite :

    • Si plugins.entries.amazon-bedrock.config.discovery.enabled vaut true, OpenClaw tente la découverte même en l’absence de marqueur d’environnement AWS.
    • Si plugins.entries.amazon-bedrock.config.discovery.enabled n’est pas défini, OpenClaw n’ajoute automatiquement le fournisseur Bedrock implicite que lorsqu’il détecte l’un des marqueurs d’authentification AWS suivants : AWS_BEARER_TOKEN_BEDROCK, AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY ou AWS_PROFILE.
    • Le chemin d’authentification réel de l’environnement d’exécution Bedrock utilise toujours la chaîne par défaut du SDK AWS. La configuration partagée, le SSO et l’authentification par rôle d’instance IMDS peuvent donc fonctionner même si la découverte nécessitait enabled: true pour être activée.
    Options de configuration de la découverte

    Les options de configuration se trouvent sous plugins.entries.amazon-bedrock.config.discovery :

    json5
    {  plugins: {    entries: {      "amazon-bedrock": {        config: {          discovery: {            enabled: true,            region: "us-east-1",            providerFilter: ["anthropic", "amazon"],            refreshInterval: 3600,            defaultContextWindow: 32000,            defaultMaxTokens: 4096,          },        },      },    },  },}
    Option Valeur par défaut Description
    enabled automatique En mode automatique, OpenClaw n’active le fournisseur Bedrock implicite que lorsqu’il détecte un marqueur d’environnement AWS pris en charge. Définissez cette option sur true pour forcer la découverte.
    region AWS_REGION / AWS_DEFAULT_REGION / us-east-1 Région AWS utilisée pour les appels à l’API de découverte.
    providerFilter (tous) Correspond aux noms de fournisseurs Bedrock, par exemple anthropic ou amazon.
    refreshInterval 3600 Durée du cache en secondes. Définissez cette option sur 0 pour désactiver la mise en cache.
    defaultContextWindow 32000 Fenêtre de contexte utilisée pour les modèles découverts dont les limites de jetons sont inconnues ; remplacez cette valeur si vous connaissez les limites de votre modèle.
    defaultMaxTokens 4096 Nombre maximal de jetons de sortie utilisé pour les modèles découverts dont les limites de jetons sont inconnues ; remplacez cette valeur si vous connaissez les limites de votre modèle.
    Fenêtre de contexte et limites maximales de jetons

    Les API Bedrock ListFoundationModels et GetFoundationModel ne renvoient aucune métadonnée sur les limites de jetons, mais uniquement l’identifiant, le nom, les modalités et l’état du cycle de vie du modèle. OpenClaw fournit une table de correspondance des fenêtres de contexte et des limites de sortie connues pour les modèles Bedrock courants (Claude, Nova, Llama, Mistral, DeepSeek et d’autres), afin que la gestion des sessions, les seuils de Compaction et la détection des dépassements de contexte fonctionnent correctement pour ces modèles.

    Les modèles découverts qui ne figurent pas dans la table utilisent par défaut defaultContextWindow et defaultMaxTokens. Si les limites précises d’un modèle que vous utilisez sont absentes, remplacez-les à l’aide d’une entrée explicite models.providers["amazon-bedrock"].models.

    Configuration rapide (parcours AWS)

    Cette procédure crée un rôle IAM, lui associe les autorisations Bedrock, associe le profil d’instance et active la découverte OpenClaw sur l’hôte EC2.

    bash
    # 1. Créer le rôle IAM et le profil d’instanceaws iam create-role --role-name EC2-Bedrock-Access \  --assume-role-policy-document '{    "Version": "2012-10-17",    "Statement": [{      "Effect": "Allow",      "Principal": {"Service": "ec2.amazonaws.com"},      "Action": "sts:AssumeRole"    }]  }' aws iam attach-role-policy --role-name EC2-Bedrock-Access \  --policy-arn arn:aws:iam::aws:policy/AmazonBedrockFullAccess aws iam create-instance-profile --instance-profile-name EC2-Bedrock-Accessaws iam add-role-to-instance-profile \  --instance-profile-name EC2-Bedrock-Access \  --role-name EC2-Bedrock-Access # 2. L’associer à votre instance EC2aws ec2 associate-iam-instance-profile \  --instance-id i-xxxxx \  --iam-instance-profile Name=EC2-Bedrock-Access # 3. Sur l’instance EC2, activer explicitement la découverteopenclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1 # 4. Facultatif : ajouter un marqueur d’environnement si vous souhaitez utiliser le mode automatique sans activation expliciteecho 'export AWS_PROFILE=default' >> ~/.bashrcecho 'export AWS_REGION=us-east-1' >> ~/.bashrcsource ~/.bashrc # 5. Vérifier que les modèles sont découvertsopenclaw models list

    Configuration avancée

    Profils d’inférence

    OpenClaw découvre les profils d’inférence régionaux et globaux en plus des modèles de fondation. Lorsqu’un profil correspond à un modèle de fondation connu, il hérite des capacités de ce modèle (fenêtre de contexte, nombre maximal de jetons, raisonnement, vision), et la région de requête Bedrock appropriée est injectée automatiquement. Les profils Claude interrégionaux fonctionnent ainsi sans remplacement manuel du fournisseur. Les profils globaux interrégionaux (global.*) apparaissent en premier dans openclaw models list, car ils offrent généralement une meilleure capacité et un basculement automatique.

    Les identifiants de profils d’inférence ressemblent à us.anthropic.claude-opus-4-6-v1:0 (régional) ou anthropic.claude-opus-4-6-v1:0 (global). Si le modèle sous-jacent figure déjà dans les résultats de découverte, le profil hérite de l’ensemble de ses capacités ; sinon, des valeurs par défaut sûres s’appliquent.

    Aucune configuration supplémentaire n’est nécessaire. Tant que la découverte est activée et que le principal IAM dispose de bedrock:ListInferenceProfiles, les profils apparaissent avec les modèles de fondation dans openclaw models list.

    Niveau de service

    Certains modèles Bedrock prennent en charge un paramètre service_tier permettant d’optimiser les coûts ou la latence. Les niveaux suivants sont disponibles :

    Niveau Description
    default Niveau Bedrock standard
    flex Traitement à tarif réduit pour les charges de travail pouvant tolérer une latence plus longue
    priority Traitement prioritaire pour les charges de travail sensibles à la latence
    reserved Capacité réservée pour les charges de travail en régime permanent

    Définissez serviceTier (ou service_tier) via agents.defaults.params pour les requêtes de modèles Bedrock, ou par modèle dans agents.defaults.models["<model-key>"].params :

    json5
    {  agents: {    defaults: {      params: {        serviceTier: "flex", // s’applique à tous les modèles      },      models: {        "amazon-bedrock/mistral.mistral-large-3-675b-instruct": {          params: {            serviceTier: "priority", // remplacement propre au modèle          },        },      },    },  },}

    Les valeurs valides sont default, flex, priority et reserved. Claude Fable 5 et Sonnet 5 ne prennent en charge que le niveau default ; OpenClaw émet un avertissement et ignore les niveaux flex, priority ou reserved demandés pour ces modèles. Pour les autres modèles, tous les niveaux ne sont pas nécessairement pris en charge : un niveau non pris en charge renvoie une erreur de validation Bedrock, dont le message peut être trompeur (par exemple « The provided model identifier is invalid » au lieu d’indiquer que le niveau est en cause). Si cette erreur apparaît, vérifiez si le modèle prend en charge le niveau demandé.

    Claude Opus 4.7 and 4.8 temperature

    Bedrock rejette le paramètre temperature pour Claude Opus 4.7 et Opus 4.8. OpenClaw omet automatiquement temperature pour toute référence Bedrock correspondante, notamment les identifiants de modèles de fondation, les profils d’inférence nommés, les profils d’inférence d’application dont le modèle sous-jacent est résolu en Opus 4.7/4.8 via bedrock:GetInferenceProfile, ainsi que les variantes opus-4.7/opus-4.8 avec notation à points et préfixes de région facultatifs (us., eu., ap., apac., au., jp., global.). Aucun paramètre de configuration n’est requis, et cette omission s’applique à la fois à l’objet des options de la requête et au champ inferenceConfig de la charge utile.

    Claude Fable 5

    Utilisez amazon-bedrock/anthropic.claude-fable-5 dans us-east-1, ou les identifiants d’inférence régionaux tels que us.anthropic.claude-fable-5. OpenClaw applique la fenêtre de contexte de 1 million de tokens de Fable, sa limite de sortie de 128 000 tokens, son raisonnement adaptatif toujours actif et la correspondance des niveaux d’effort pris en charge. /think off et /think minimal correspondent à low ; les contrôles de température et de choix forcé des outils sont omis, comme pour la voie Opus 4.7/4.8. La sortie en streaming est retenue jusqu’à ce que Bedrock renvoie un état terminal, afin que les refus en cours de flux n’exposent aucun texte partiel.

    AWS exige une acceptation explicite de la conservation des données via provider_data_share avant que Fable soit disponible. Les invites et les réponses générées sont partagées avec Anthropic et conservées jusqu’à 30 jours à des fins de confiance et de sécurité. Consultez et configurez la conservation des données Bedrock avant d’activer le modèle.

    Claude Mythos 5

    Claude Mythos 5 est disponible via Bedrock uniquement pour les comptes disposant de l’autorisation d’accès limité requise. OpenClaw reconnaît le modèle de fondation anthropic.claude-mythos-5 ainsi que les profils d’inférence régionaux ou globaux tels que us.anthropic.claude-mythos-5.

    OpenClaw applique la fenêtre de contexte de 1 000 000 de tokens, la limite de sortie de 128 000 tokens, l’entrée d’images, la mise en cache des invites, le streaming protégeant contre l’exposition des refus et les niveaux d’effort natifs. Le raisonnement adaptatif est toujours activé : /think off et /think minimal correspondent à low, tandis que xhigh et max restent disponibles. Les valeurs personnalisées d’échantillonnage et de choix forcé des outils sont omises.

    Claude Sonnet 5

    AWS documente Sonnet 5 pour les deux points de terminaison bedrock-runtime et bedrock-mantle. OpenClaw reconnaît le modèle de fondation Bedrock anthropic.claude-sonnet-5 ainsi que les profils d’inférence régionaux ou globaux tels que us.anthropic.claude-sonnet-5. Il applique la fenêtre de contexte de 1 000 000 de tokens, la limite de sortie de 128 000 tokens, l’entrée d’images, les niveaux d’effort natifs, la mise en cache des invites et le streaming protégeant contre l’exposition des refus.

    Bedrock maintient le raisonnement adaptatif activé pour Sonnet 5. OpenClaw utilise high par défaut ; /think off et /think minimal correspondent à low, car cette voie ne peut pas désactiver le raisonnement. Les valeurs personnalisées de température et de choix forcé des outils sont omises lorsque le raisonnement adaptatif est actif.

    Guardrails

    Vous pouvez appliquer les garde-fous Amazon Bedrock à tous les appels de modèles Bedrock en ajoutant un objet guardrail à la configuration du plugin amazon-bedrock. Les garde-fous permettent d’imposer le filtrage du contenu, le refus de certains sujets, des filtres de mots, des filtres d’informations sensibles et des contrôles d’ancrage contextuel.

    json5
    {  plugins: {    entries: {      "amazon-bedrock": {        config: {          guardrail: {            guardrailIdentifier: "abc123", // guardrail ID or full ARN            guardrailVersion: "1", // version number or "DRAFT"            streamProcessingMode: "sync", // optional: "sync" or "async"            trace: "enabled", // optional: "enabled", "disabled", or "enabled_full"          },        },      },    },  },}

    guardrailIdentifier et guardrailVersion sont obligatoires.

    Option Description
    guardrailIdentifier Identifiant du garde-fou (par exemple abc123) ou ARN complet (par exemple arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123).
    guardrailVersion Numéro de version publiée, ou "DRAFT" pour le brouillon de travail.
    streamProcessingMode "sync" ou "async" pour l’évaluation du garde-fou pendant le streaming. Si cette option est omise, Bedrock utilise sa valeur par défaut.
    trace "enabled" ou "enabled_full" pour le débogage ; omettez cette option ou définissez-la sur "disabled" en production.
    Embeddings for memory search

    Bedrock peut également servir de fournisseur de plongements pour la recherche en mémoire. Cette configuration est distincte de celle du fournisseur d’inférence : définissez agents.defaults.memorySearch.provider sur "bedrock" :

    json5
    {  agents: {    defaults: {      memorySearch: {        provider: "bedrock",        model: "amazon.titan-embed-text-v2:0", // default      },    },  },}

    Les plongements Bedrock utilisent la même chaîne d’identifiants AWS SDK que l’inférence (rôles d’instance, SSO, clés d’accès, configuration partagée et identité web). Aucune clé d’API n’est nécessaire.

    Les modèles de plongement pris en charge comprennent Amazon Titan Embed (v1, v2), Amazon Nova Embed, Cohere Embed (v3, v4) et TwelveLabs Marengo. Consultez la référence de configuration de la mémoire — Bedrock pour obtenir la liste complète des modèles et les options de dimensions.

    Notes and caveats
    • Bedrock exige que l’accès aux modèles soit activé dans votre compte et votre région AWS.
    • La découverte automatique nécessite les autorisations bedrock:ListFoundationModels et bedrock:ListInferenceProfiles.
    • Si vous utilisez le mode automatique, définissez l’un des marqueurs d’environnement d’authentification AWS pris en charge sur l’hôte du Gateway. Si vous préférez l’authentification IMDS ou par configuration partagée sans marqueurs d’environnement, définissez plugins.entries.amazon-bedrock.config.discovery.enabled: true.
    • OpenClaw indique la source des identifiants dans l’ordre suivant : AWS_BEARER_TOKEN_BEDROCK, puis AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY, puis AWS_PROFILE, puis la chaîne AWS SDK par défaut.
    • La prise en charge du raisonnement dépend du modèle ; consultez la fiche du modèle Bedrock pour connaître ses capacités actuelles.
    • Si vous préférez un flux à clé gérée, vous pouvez également placer un proxy compatible avec OpenAI devant Bedrock et le configurer comme fournisseur OpenAI.

    Ressources connexes

    Was this useful?
    On this page

    On this page