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
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" :
{ 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
openclaw models listRô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 :
openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1Ajouter é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 :
export AWS_PROFILE=defaultexport AWS_REGION=us-east-1Vous n’avez pas besoin d’une fausse clé d’API.
Vérifier que les modèles sont découverts
openclaw models listDé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.enabledvauttrue, OpenClaw tente la découverte même en l’absence de marqueur d’environnement AWS. - Si
plugins.entries.amazon-bedrock.config.discovery.enabledn’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_KEYouAWS_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: truepour être activée.
Options de configuration de la découverte
Les options de configuration se trouvent sous plugins.entries.amazon-bedrock.config.discovery :
{ 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.
# 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 listConfiguration 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 :
{ 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.
{ 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" :
{ 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:ListFoundationModelsetbedrock: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, puisAWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY, puisAWS_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
Choix des fournisseurs, des références de modèles et du comportement de basculement.
Plongements Bedrock pour la configuration de la recherche en mémoire.
Liste complète des modèles de plongement Bedrock et options de dimensions.
Dépannage général et questions fréquentes.