--- read_when: - Vous souhaitez utiliser les modèles Amazon Bedrock avec OpenClaw - Vous devez configurer les identifiants et la région AWS pour les appels au modèle summary: Utiliser les modèles Amazon Bedrock (Converse API) avec OpenClaw title: Amazon Bedrock x-i18n: generated_at: "2026-06-27T18:03:15Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 3947ad565f3a0adcd62d4ce47c6ed760f73c77ba3f4bd43b0754a412511063f2 source_path: providers/bedrock.md workflow: 16 --- 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 AWS SDK**, 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`) | ## Premiers pas Choisissez votre méthode d’authentification préférée et suivez les étapes de configuration. **Idéal pour :** les machines de développement, la CI ou les hôtes où vous gérez directement les identifiants AWS. ```bash export AWS_ACCESS_KEY_ID="EXAMPLE_AWS_ACCESS_KEY_ID" export AWS_SECRET_ACCESS_KEY="..." export AWS_REGION="us-east-1" # Optional: export AWS_SESSION_TOKEN="..." export AWS_PROFILE="your-profile" # Optional (Bedrock API key/bearer token): export AWS_BEARER_TOKEN_BEDROCK="..." ``` Aucune `apiKey` n’est requise. 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" }, }, }, } ``` ```bash openclaw models list ``` Avec l’authentification par marqueur d’environnement (`AWS_ACCESS_KEY_ID`, `AWS_PROFILE` ou `AWS_BEARER_TOKEN_BEDROCK`), OpenClaw active automatiquement le fournisseur Bedrock implicite pour la découverte de modèles sans configuration supplémentaire. **Idéal pour :** les instances EC2 auxquelles un rôle IAM est attaché, utilisant le service de métadonnées d’instance pour l’authentification. 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 true openclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1 ``` Si vous voulez aussi que le chemin d’auto-détection par marqueur d’environnement fonctionne (par exemple, pour les surfaces `openclaw status`) : ```bash export AWS_PROFILE=default export AWS_REGION=us-east-1 ``` Vous n’avez **pas** besoin d’une fausse clé d’API. ```bash openclaw models list ``` Le rôle IAM attaché à votre instance EC2 doit disposer des autorisations suivantes : - `bedrock:InvokeModel` - `bedrock:InvokeModelWithResponseStream` - `bedrock:ListFoundationModels` (pour la découverte automatique) - `bedrock:ListInferenceProfiles` (pour la découverte des profils d’inférence) Ou attachez la politique gérée `AmazonBedrockFullAccess`. Vous n’avez besoin de `AWS_PROFILE=default` que si vous voulez spécifiquement un marqueur d’environnement pour le mode automatique ou les surfaces de statut. Le chemin réel d’authentification de l’environnement d’exécution Bedrock utilise la chaîne par défaut du AWS SDK ; l’authentification par rôle d’instance IMDS fonctionne donc même sans marqueurs d’environnement. ## Découverte automatique des modèles OpenClaw peut découvrir automatiquement les modèles Bedrock qui prennent en charge le **streaming** et la **sortie texte**. La découverte utilise `bedrock:ListFoundationModels` et `bedrock:ListInferenceProfiles`, et les résultats sont mis en cache (par défaut : 1 heure). Mode d’activation du fournisseur implicite : - Si `plugins.entries.amazon-bedrock.config.discovery.enabled` vaut `true`, OpenClaw tentera la découverte même lorsqu’aucun marqueur d’environnement AWS n’est présent. - Si `plugins.entries.amazon-bedrock.config.discovery.enabled` n’est pas défini, OpenClaw ajoute automatiquement le fournisseur Bedrock implicite uniquement lorsqu’il détecte l’un de ces marqueurs d’authentification AWS : `AWS_BEARER_TOKEN_BEDROCK`, `AWS_ACCESS_KEY_ID` + `AWS_SECRET_ACCESS_KEY`, ou `AWS_PROFILE`. - Le chemin réel d’authentification du runtime Bedrock utilise toujours la chaîne par défaut du SDK AWS, donc la configuration partagée, SSO et l’authentification IMDS par rôle d’instance peuvent fonctionner même lorsque la découverte nécessitait `enabled: true` pour être activée. Pour les entrées explicites `models.providers["amazon-bedrock"]`, OpenClaw peut toujours résoudre tôt l’authentification Bedrock par marqueur d’environnement à partir de marqueurs d’environnement AWS comme `AWS_BEARER_TOKEN_BEDROCK`, sans forcer le chargement complet de l’authentification du runtime. Le chemin réel d’authentification des appels de modèle utilise toujours la chaîne par défaut du SDK AWS. 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` | auto | 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 `true` pour forcer la découverte. | | `region` | `AWS_REGION` / `AWS_DEFAULT_REGION` / `us-east-1` | Région AWS utilisée pour les appels API de découverte. | | `providerFilter` | (tous) | Correspond aux noms de fournisseurs Bedrock (par exemple `anthropic`, `amazon`). | | `refreshInterval` | `3600` | Durée du cache en secondes. Définissez sur `0` pour désactiver la mise en cache. | | `defaultContextWindow` | `32000` | Fenêtre de contexte utilisée pour les modèles découverts (à remplacer si vous connaissez les limites de votre modèle). | | `defaultMaxTokens` | `4096` | Nombre maximal de tokens de sortie utilisé pour les modèles découverts (à remplacer si vous connaissez les limites de votre modèle). | ## Configuration rapide (chemin AWS) Ce guide crée un rôle IAM, attache les autorisations Bedrock, associe le profil d’instance et active la découverte OpenClaw sur l’hôte EC2. ```bash # 1. Create IAM role and instance profile aws 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-Access aws iam add-role-to-instance-profile \ --instance-profile-name EC2-Bedrock-Access \ --role-name EC2-Bedrock-Access # 2. Attach to your EC2 instance aws ec2 associate-iam-instance-profile \ --instance-id i-xxxxx \ --iam-instance-profile Name=EC2-Bedrock-Access # 3. On the EC2 instance, enable discovery explicitly openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled true openclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1 # 4. Optional: add an env marker if you want auto mode without explicit enable echo 'export AWS_PROFILE=default' >> ~/.bashrc echo 'export AWS_REGION=us-east-1' >> ~/.bashrc source ~/.bashrc # 5. Verify models are discovered openclaw models list ``` ## Configuration avancée OpenClaw découvre les **profils d’inférence régionaux et globaux** en même temps que les modèles de fondation. Lorsqu’un profil correspond à un modèle de fondation connu, le profil hérite des capacités de ce modèle (fenêtre de contexte, tokens max., raisonnement, vision) et la bonne région de requête Bedrock est injectée automatiquement. Cela signifie que les profils Claude interrégionaux fonctionnent sans remplacement manuel du fournisseur. Les ID 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 complet 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 aux côtés des modèles de fondation dans `openclaw models list`. Certains modèles Bedrock prennent en charge un paramètre `service_tier` pour optimiser le coût ou la latence. Les niveaux suivants sont disponibles : | Niveau | Description | |------|-------------| | `default` | Niveau Bedrock standard | | `flex` | Traitement à prix 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 stables | Définissez `serviceTier` (ou `service_tier`) via `agents.defaults.params` pour les requêtes de modèle Bedrock, ou par modèle dans `agents.defaults.models[""].params` : ```json5 { agents: { defaults: { params: { serviceTier: "flex", // applies to all models }, models: { "amazon-bedrock/mistral.mistral-large-3-675b-instruct": { params: { serviceTier: "priority", // per-model override }, }, }, }, }, } ``` Les valeurs valides sont `default`, `flex`, `priority` et `reserved`. Tous les modèles ne prennent pas en charge tous les niveaux — si un niveau non pris en charge est demandé, Bedrock renverra une erreur de validation. Remarque : le message d’erreur est quelque peu trompeur ; il peut indiquer « The provided model identifier is invalid » plutôt que signaler un niveau de service non pris en charge. Si vous voyez cette erreur, vérifiez si le modèle prend en charge le niveau demandé. Bedrock rejette le paramètre `temperature` pour Claude Opus 4.7. OpenClaw omet automatiquement `temperature` pour toute référence Bedrock Opus 4.7, y compris les ID 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 se résout en Opus 4.7 via `bedrock:GetInferenceProfile`, et les variantes pointées `opus-4.7` avec préfixes de région facultatifs (`us.`, `eu.`, `ap.`, `apac.`, `au.`, `jp.`, `global.`). Aucun paramètre de configuration n’est requis, et l’omission s’applique à la fois à l’objet d’options de requête et au champ de charge utile `inferenceConfig`. Utilisez `amazon-bedrock/anthropic.claude-fable-5` dans `us-east-1`, ou les identifiants d’inférence régionaux comme `us.anthropic.claude-fable-5`. OpenClaw applique la fenêtre de contexte 1M de Fable, la limite de sortie de 128K, le raisonnement adaptatif toujours actif et le mappage d’effort pris en charge. `/think off` et `/think minimal` correspondent à `low`; les contrôles non pris en charge de température et de choix forcé d’outil sont omis. La sortie en streaming est retenue jusqu’à ce que Bedrock renvoie un état terminal afin que les refus en cours de flux n’exposent pas de texte partiel. Fable ne prend en charge que le niveau de service standard; OpenClaw ignore les niveaux `flex`, `priority` et `reserved` configurés pour ce modèle. AWS exige une acceptation explicite de conservation des données `provider_data_share` avant que Fable soit disponible. Les prompts et les complétions sont partagés avec Anthropic et conservés jusqu’à 30 jours à des fins de confiance et de sécurité. Examinez et configurez la [conservation des données Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/data-retention.html) avant d’activer le modèle. Vous pouvez appliquer les [Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html) à tous les appels de modèles Bedrock en ajoutant un objet `guardrail` à la configuration du plugin `amazon-bedrock`. Les Guardrails vous permettent d’imposer le filtrage de contenu, le refus de sujets, les filtres de mots, les filtres d’informations sensibles et les vérifications 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" }, }, }, }, }, } ``` | Option | Obligatoire | Description | | ------ | -------- | ----------- | | `guardrailIdentifier` | Oui | ID du guardrail (par ex. `abc123`) ou ARN complet (par ex. `arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123`). | | `guardrailVersion` | Oui | Numéro de version publiée, ou `"DRAFT"` pour le brouillon de travail. | | `streamProcessingMode` | Non | `"sync"` ou `"async"` pour l’évaluation du guardrail pendant le streaming. Si cette option est omise, Bedrock utilise sa valeur par défaut. | | `trace` | Non | `"enabled"` ou `"enabled_full"` pour le débogage; omettez cette option ou définissez `"disabled"` pour la production. | Le principal IAM utilisé par le Gateway doit disposer de l’autorisation `bedrock:ApplyGuardrail` en plus des autorisations d’appel standard. Bedrock peut aussi servir de fournisseur d’embeddings pour la [recherche en mémoire](/fr/concepts/memory-search). Cette configuration est distincte 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 embeddings 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. Définissez explicitement `memorySearch.provider: "bedrock"` pour utiliser les embeddings Bedrock. Les modèles d’embedding pris en charge incluent 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](/fr/reference/memory-config#bedrock-embedding-config) pour obtenir la liste complète des modèles et les options de dimensions. - Bedrock exige que **l’accès au modèle** soit activé dans votre compte/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/configuration partagée sans marqueurs d’environnement, définissez `plugins.entries.amazon-bedrock.config.discovery.enabled: true`. - OpenClaw expose la source des identifiants dans cet ordre: `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 les capacités actuelles. - Si vous préférez un flux de clés géré, vous pouvez aussi placer un proxy compatible OpenAI devant Bedrock et le configurer plutôt comme fournisseur OpenAI. ## Connexe Choix des fournisseurs, des références de modèles et du comportement de basculement. Embeddings Bedrock pour la configuration de la recherche en mémoire. Liste complète des modèles d’embedding Bedrock et options de dimensions. Dépannage général et FAQ.