Providers
Amazon Bedrock
OpenClaw kan Amazon Bedrock-modellen gebruiken via de streamingprovider Bedrock Converse. Bedrock-authenticatie gebruikt de standaardreferentieketen van de AWS SDK, niet een API-sleutel.
| Eigenschap | Waarde |
|---|---|
| Provider | amazon-bedrock |
| API | bedrock-converse-stream |
| Authenticatie | AWS-referenties (omgevingsvariabelen, gedeelde configuratie of instantirol) |
| Regio | AWS_REGION of AWS_DEFAULT_REGION (standaard: us-east-1) |
Aan de slag
Kies de gewenste authenticatiemethode en volg de configuratiestappen.
Toegangssleutels / omgevingsvariabelen
Meest geschikt voor: ontwikkelaarsmachines, CI of hosts waarop je AWS-referenties rechtstreeks beheert.
Stel AWS-referenties in op de Gateway-host
export AWS_ACCESS_KEY_ID="EXAMPLE_AWS_ACCESS_KEY_ID"export AWS_SECRET_ACCESS_KEY="..."export AWS_REGION="us-east-1"# Optioneel:export AWS_SESSION_TOKEN="..."export AWS_PROFILE="your-profile"# Optioneel (Bedrock API-sleutel/bearertoken):export AWS_BEARER_TOKEN_BEDROCK="..."Voeg een Bedrock-provider en -model toe aan je configuratie
Er is geen apiKey vereist. Configureer de provider met 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", 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" }, }, },}Controleer of modellen beschikbaar zijn
openclaw models listEC2-instantirollen (IMDS)
Meest geschikt voor: EC2-instanties waaraan een IAM-rol is gekoppeld en die de metadataservice voor instanties gebruiken voor authenticatie.
Schakel detectie expliciet in
Bij gebruik van IMDS kan OpenClaw AWS-authenticatie niet uitsluitend aan de hand van omgevingsmarkeringen detecteren. Je moet dit daarom expliciet inschakelen:
openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1Voeg desgewenst een omgevingsmarkering toe voor de automatische modus
Als je ook wilt dat het automatische detectiepad via omgevingsmarkeringen werkt (bijvoorbeeld voor openclaw status-oppervlakken):
export AWS_PROFILE=defaultexport AWS_REGION=us-east-1Je hebt geen fictieve API-sleutel nodig.
Controleer of modellen zijn gedetecteerd
openclaw models listAutomatische modeldetectie
OpenClaw kan automatisch Bedrock-modellen detecteren die streaming
en tekstuitvoer ondersteunen. De detectie gebruikt bedrock:ListFoundationModels en
bedrock:ListInferenceProfiles, en de resultaten worden in de cache opgeslagen (standaard: 1 uur).
Zo wordt de impliciete provider ingeschakeld:
- Als
plugins.entries.amazon-bedrock.config.discovery.enabledtrueis, probeert OpenClaw detectie uit te voeren, zelfs als er geen AWS-omgevingsmarkering aanwezig is. - Als
plugins.entries.amazon-bedrock.config.discovery.enabledniet is ingesteld, voegt OpenClaw de impliciete Bedrock-provider alleen automatisch toe wanneer een van deze AWS-authenticatiemarkeringen wordt aangetroffen:AWS_BEARER_TOKEN_BEDROCK,AWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEYofAWS_PROFILE. - Het daadwerkelijke authenticatiepad van de Bedrock-runtime gebruikt nog steeds de standaardketen van de AWS SDK. Daardoor kunnen gedeelde configuratie, SSO en authenticatie via een IMDS-instantirol werken, zelfs wanneer voor detectie
enabled: truenodig was om deze in te schakelen.
Configuratieopties voor detectie
Configuratieopties bevinden zich onder 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, }, }, }, }, },}| Optie | Standaard | Beschrijving |
|---|---|---|
enabled |
automatisch | In de automatische modus schakelt OpenClaw de impliciete Bedrock-provider alleen in wanneer een ondersteunde AWS-omgevingsmarkering wordt aangetroffen. Stel true in om detectie af te dwingen. |
region |
AWS_REGION / AWS_DEFAULT_REGION / us-east-1 |
AWS-regio die wordt gebruikt voor API-aanroepen voor detectie. |
providerFilter |
(alle) | Komt overeen met namen van Bedrock-providers (bijvoorbeeld anthropic, amazon). |
refreshInterval |
3600 |
Cacheduur in seconden. Stel in op 0 om caching uit te schakelen. |
defaultContextWindow |
32000 |
Contextvenster dat wordt gebruikt voor gedetecteerde modellen zonder bekende tokenlimieten (overschrijf dit als je de limieten van je model kent). |
defaultMaxTokens |
4096 |
Maximaal aantal uitvoertokens dat wordt gebruikt voor gedetecteerde modellen zonder bekende tokenlimieten (overschrijf dit als je de limieten van je model kent). |
Contextvenster en limieten voor het maximale aantal tokens
De Bedrock-API's ListFoundationModels en GetFoundationModel retourneren geen
metagegevens over tokenlimieten, maar alleen de model-ID, naam, modaliteiten en levenscyclusstatus.
OpenClaw wordt geleverd met een opzoektabel van bekende contextvensters en uitvoerlimieten
voor populaire Bedrock-modellen (Claude, Nova, Llama, Mistral, DeepSeek
en andere), zodat sessiebeheer, Compaction-drempels en
detectie van contextoverschrijding correct werken voor deze modellen.
Gedetecteerde modellen die niet in de tabel staan, vallen terug op defaultContextWindow
en defaultMaxTokens. Als voor een model dat je gebruikt nauwkeurige limieten ontbreken,
overschrijf je deze met een expliciete
models.providers["amazon-bedrock"].models-vermelding.
Snelle configuratie (AWS-pad)
Deze stapsgewijze uitleg maakt een IAM-rol, koppelt Bedrock-machtigingen, associeert het instantieprofiel en schakelt OpenClaw-detectie in op de EC2-host.
# 1. Maak een IAM-rol en instantieprofielaws 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. Koppel aan je EC2-instantieaws ec2 associate-iam-instance-profile \ --instance-id i-xxxxx \ --iam-instance-profile Name=EC2-Bedrock-Access # 3. Schakel detectie expliciet in op de EC2-instantieopenclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1 # 4. Optioneel: voeg een omgevingsmarkering toe als je de automatische modus zonder expliciete inschakeling wiltecho 'export AWS_PROFILE=default' >> ~/.bashrcecho 'export AWS_REGION=us-east-1' >> ~/.bashrcsource ~/.bashrc # 5. Controleer of modellen zijn gedetecteerdopenclaw models listGeavanceerde configuratie
Inferentieprofielen
OpenClaw detecteert regionale en globale inferentieprofielen naast
basismodellen. Wanneer een profiel naar een bekend basismodel verwijst, neemt
het profiel de mogelijkheden van dat model over (contextvenster, maximaal aantal tokens,
redeneren, beeldverwerking) en wordt automatisch de juiste Bedrock-aanvraagregio
ingevoegd. Dit betekent dat regioverschrijdende Claude-profielen zonder handmatige
provideroverschrijvingen werken. Globale regioverschrijdende profielen (global.*) worden
als eerste vermeld in openclaw models list, omdat ze doorgaans betere capaciteit
en automatische failover bieden.
ID's van inferentieprofielen zien eruit als us.anthropic.claude-opus-4-6-v1 (regionaal)
of anthropic.claude-opus-4-6-v1 (globaal). Als het onderliggende model al
in de detectieresultaten staat, neemt het profiel de volledige reeks mogelijkheden ervan over;
anders gelden veilige standaardwaarden.
Er is geen extra configuratie nodig. Zolang detectie is ingeschakeld en de IAM-principal
bedrock:ListInferenceProfiles heeft, verschijnen profielen naast
basismodellen in openclaw models list.
Serviceniveau
Sommige Bedrock-modellen ondersteunen een parameter service_tier om kosten
of latentie te optimaliseren. De volgende niveaus zijn beschikbaar:
| Niveau | Beschrijving |
|---|---|
default |
Standaardniveau van Bedrock |
flex |
Verwerking met korting voor workloads die een langere latentie kunnen verdragen |
priority |
Verwerking met prioriteit voor latentiegevoelige workloads |
reserved |
Gereserveerde capaciteit voor workloads met een constante belasting |
Stel serviceTier (of service_tier) via agents.defaults.params in voor
Bedrock-modelaanvragen, of per model in
agents.defaults.models["<model-key>"].params:
{ agents: { defaults: { params: { serviceTier: "flex", // geldt voor alle modellen }, models: { "amazon-bedrock/mistral.mistral-large-3-675b-instruct": { params: { serviceTier: "priority", // overschrijving per model }, }, }, }, },}Geldige waarden zijn default, flex, priority en reserved. Claude
Fable 5, Opus 5 en Sonnet 5 ondersteunen alleen het niveau default; OpenClaw waarschuwt en
negeert flex, priority of reserved wanneer deze voor die modellen worden aangevraagd. Voor
andere modellen geldt dat niet elk model elk niveau ondersteunt -- een niet-ondersteund niveau
retourneert een Bedrock-validatiefout en de foutmelding kan
misleidend zijn (bijvoorbeeld "The provided model identifier is invalid"
in plaats van het niveau als probleem te benoemen). Controleer bij deze fout
of het model het aangevraagde niveau ondersteunt.
Temperatuur voor Claude Opus 5, 4.8 en 4.7
Bedrock weigert de parameter temperature voor Claude Opus 5, Opus 4.8
en Opus 4.7. OpenClaw laat temperature automatisch weg voor elke overeenkomende Bedrock-
ref, waaronder foundationmodel-id's, benoemde inferentieprofielen, applicatie-
inferentieprofielen waarvan het onderliggende model via
bedrock:GetInferenceProfile wordt herleid tot Opus 5/4.8/4.7, en varianten met punten van
opus-4.7/opus-4.8 met optionele regiovoorvoegsels (us., eu., ap., apac., au., jp.,
global.). Er is geen configuratieoptie vereist en de weglating geldt zowel voor
het object met aanvraagopties als voor het payloadveld inferenceConfig.
Claude Opus 5
Gebruik amazon-bedrock/anthropic.claude-opus-5 op het Bedrock-eindpunt van de Messages-API,
of een regionaal/globaal inferentieprofiel zoals
global.anthropic.claude-opus-5 wanneer dit in Bedrock-detectie verschijnt.
OpenClaw past het contextvenster van 1,000,000 tokens, de uitvoerlimiet van 128,000 tokens,
afbeeldingsinvoer, promptcaching, veilig streamen bij weigeringen en native
inspanningsniveaus xhigh/max toe.
Adaptief denken is standaard ingesteld op high. /think off schakelt denken uit, terwijl
/think xhigh|max adaptief denken ingeschakeld houdt. OpenClaw laat aangepaste
samplingparameters en niet-ondersteunde niet-standaard serviceniveaus weg.
Claude Fable 5
Gebruik amazon-bedrock/anthropic.claude-fable-5 in us-east-1, of de
regionale inferentie-id's zoals us.anthropic.claude-fable-5.
OpenClaw past Fable's contextvenster van 1M, uitvoerlimiet van 128K, permanent
ingeschakeld adaptief denken en ondersteunde inspanningstoewijzing toe. /think off en
/think minimal worden toegewezen aan low; temperatuur en besturingselementen voor gedwongen toolkeuze
worden weggelaten, in overeenstemming met de Opus 4.7/4.8-route. Gestreamde uitvoer wordt vastgehouden
totdat Bedrock een eindstatus retourneert, zodat weigeringen tijdens het streamen geen
gedeeltelijke tekst blootleggen.
AWS vereist expliciete aanmelding voor gegevensbewaring via provider_data_share voordat
Fable beschikbaar is. Prompts en voltooiingen worden met Anthropic gedeeld en
maximaal 30 dagen bewaard voor vertrouwen en veiligheid. Controleer en configureer
gegevensbewaring van Bedrock
voordat je het model inschakelt.
Claude Mythos 5
Claude Mythos 5 is via Bedrock alleen beschikbaar voor accounts met de
vereiste goedkeuring voor beperkte toegang. OpenClaw herkent het foundationmodel
anthropic.claude-mythos-5 en regionale of globale inferentieprofielen zoals
us.anthropic.claude-mythos-5.
OpenClaw past het contextvenster van 1,000,000 tokens, de uitvoerlimiet van 128,000 tokens,
afbeeldingsinvoer, promptcaching, veilig streamen bij weigeringen en native
inspanningsniveaus toe. Adaptief denken is altijd ingeschakeld: /think off en
/think minimal worden toegewezen aan low, terwijl xhigh en max beschikbaar blijven.
Aangepaste samplingwaarden en waarden voor gedwongen toolkeuze worden weggelaten.
Claude Sonnet 5
AWS documenteert Sonnet 5 voor zowel de
eindpunten bedrock-runtime en bedrock-mantle.
OpenClaw herkent het Bedrock-foundationmodel
anthropic.claude-sonnet-5 en regionale of globale inferentieprofielen zoals
us.anthropic.claude-sonnet-5. Het past het contextvenster van 1,000,000 tokens,
de uitvoerlimiet van 128,000 tokens, afbeeldingsinvoer, native inspanningsniveaus,
promptcaching en veilig streamen bij weigeringen toe.
Bedrock houdt adaptief denken ingeschakeld voor Sonnet 5. OpenClaw gebruikt standaard
high; /think off en /think minimal worden toegewezen aan low, omdat deze route
denken niet kan uitschakelen. Aangepaste temperatuurwaarden en waarden voor gedwongen toolkeuze
worden weggelaten zolang adaptief denken actief is.
Beveiligingsregels
Je kunt Amazon Bedrock Guardrails
toepassen op alle aanroepen van Bedrock-modellen door een object guardrail toe te voegen aan de
Plugin-configuratie amazon-bedrock. Met beveiligingsregels kun je inhoudsfiltering,
het weigeren van onderwerpen, woordfilters, filters voor gevoelige informatie en controles voor
contextuele onderbouwing afdwingen.
{ plugins: { entries: { "amazon-bedrock": { config: { guardrail: { guardrailIdentifier: "abc123", // ID van beveiligingsregel of volledige ARN guardrailVersion: "1", // versienummer of "DRAFT" streamProcessingMode: "sync", // optioneel: "sync" of "async" trace: "enabled", // optioneel: "enabled", "disabled" of "enabled_full" }, }, }, }, },}guardrailIdentifier en guardrailVersion zijn vereist.
| Optie | Beschrijving |
|---|---|
guardrailIdentifier |
ID van beveiligingsregel (bijv. abc123) of volledige ARN (bijv. arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123). |
guardrailVersion |
Gepubliceerd versienummer, of "DRAFT" voor het werkconcept. |
streamProcessingMode |
"sync" of "async" voor evaluatie van beveiligingsregels tijdens het streamen. Als dit wordt weggelaten, gebruikt Bedrock de standaardwaarde. |
trace |
"enabled" of "enabled_full" voor foutopsporing; laat dit weg of stel "disabled" in voor productie. |
Embeddings voor geheugenzoekopdrachten
Bedrock kan ook dienen als embeddingprovider voor
geheugenzoekopdrachten. Dit wordt afzonderlijk van de
inferentieprovider geconfigureerd -- stel memory.search.provider in op "bedrock":
{ memory: { search: { provider: "bedrock", model: "amazon.titan-embed-text-v2:0", // standaard }, },}Bedrock-embeddings gebruiken dezelfde AWS SDK-referentieketen als inferentie (instantie- rollen, SSO, toegangssleutels, gedeelde configuratie en webidentiteit). Er is geen API-sleutel nodig.
Ondersteunde embeddingmodellen zijn onder andere Amazon Titan Embed (v1, v2), Amazon Nova Embed, Cohere Embed (v3, v4) en TwelveLabs Marengo. Zie Referentie voor geheugenconfiguratie -- Bedrock voor de volledige modellenlijst en dimensieopties.
Opmerkingen en aandachtspunten
- Voor Bedrock moet modeltoegang zijn ingeschakeld in je AWS-account/regio.
- Automatische detectie vereist de machtigingen
bedrock:ListFoundationModelsenbedrock:ListInferenceProfiles. - Als je de automatische modus gebruikt, stel je een van de ondersteunde AWS-omgevingsmarkeringen voor authenticatie in op de
Gateway-host. Als je IMDS-/gedeelde-configuratie-authenticatie zonder omgevingsmarkeringen verkiest, stel je
plugins.entries.amazon-bedrock.config.discovery.enabled: truein. - OpenClaw toont de referentiebron in deze volgorde:
AWS_BEARER_TOKEN_BEDROCK, vervolgensAWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY, daarnaAWS_PROFILEen vervolgens de standaard AWS SDK-keten. - Ondersteuning voor redeneren is afhankelijk van het model; raadpleeg de Bedrock-modelkaart voor de huidige mogelijkheden.
- Als je de voorkeur geeft aan een beheerde sleutelprocedure, kun je ook een OpenAI-compatibele proxy vóór Bedrock plaatsen en deze in plaats daarvan configureren als OpenAI-provider.
Gerelateerd
Providers, modelrefs en failovergedrag kiezen.
Bedrock-embeddings voor de configuratie van geheugenzoekopdrachten.
Volledige lijst van Bedrock-embeddingmodellen en dimensieopties.
Algemene probleemoplossing en veelgestelde vragen.