Providers
Amazon Bedrock
OpenClaw kan Amazon Bedrock-modellen gebruiken via zijn streamingprovider Bedrock Converse. Bedrock-verificatie gebruikt de standaardreferentieketen van de AWS SDK, niet een API-sleutel.
| Eigenschap | Waarde |
|---|---|
| Provider | amazon-bedrock |
| API | bedrock-converse-stream |
| Verificatie | AWS-referenties (omgevingsvariabelen, gedeelde configuratie of instantierol) |
| Regio | AWS_REGION of AWS_DEFAULT_REGION (standaard: us-east-1) |
Aan de slag
Kies de gewenste verificatiemethode en volg de installatiestappen.
Toegangssleutels / omgevingsvariabelen
Meest geschikt voor: ontwikkelcomputers, CI of hosts waarop u 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 uw 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: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" }, }, },}Controleer of modellen beschikbaar zijn
openclaw models listEC2-instantierollen (IMDS)
Meest geschikt voor: EC2-instanties waaraan een IAM-rol is gekoppeld en die de instantiemetadataservice gebruiken voor verificatie.
Schakel detectie expliciet in
Bij gebruik van IMDS kan OpenClaw AWS-verificatie niet alleen aan de hand van omgevingsmarkeringen detecteren. Daarom moet u dit 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 u ook wilt dat automatische detectie via omgevingsmarkeringen werkt (bijvoorbeeld voor openclaw status-weergaven):
export AWS_PROFILE=defaultexport AWS_REGION=us-east-1U 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. Detectie gebruikt bedrock:ListFoundationModels en
bedrock:ListInferenceProfiles, en 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 wanneer 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-verificatiemarkeringen wordt aangetroffen:AWS_BEARER_TOKEN_BEDROCK,AWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEYofAWS_PROFILE. - Het daadwerkelijke Bedrock-runtimeverificatiepad gebruikt nog steeds de standaardketen van de AWS SDK,
zodat gedeelde configuratie, SSO en verificatie via een IMDS-instantierol kunnen werken,
zelfs wanneer voor detectie
enabled: truenodig was om dit expliciet 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 in op true 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 (pas dit aan als u de limieten van uw model kent). |
defaultMaxTokens |
4096 |
Maximaal aantal uitvoertokens dat wordt gebruikt voor gedetecteerde modellen zonder bekende tokenlimieten (pas dit aan als u de limieten van uw 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 bevat een opzoektabel met 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 u gebruikt nauwkeurige limieten ontbreken,
overschrijft u deze met een expliciete
models.providers["amazon-bedrock"].models-vermelding.
Snelle installatie (AWS-traject)
Deze stapsgewijze uitleg maakt een IAM-rol aan, koppelt Bedrock-machtigingen, associeert het instantieprofiel en schakelt OpenClaw-detectie in op de EC2-host.
# 1. IAM-rol en instantieprofiel aanmakenaws 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. Aan uw EC2-instantie koppelenaws ec2 associate-iam-instance-profile \ --instance-id i-xxxxx \ --iam-instance-profile Name=EC2-Bedrock-Access # 3. Detectie expliciet inschakelen 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: een omgevingsmarkering toevoegen als u de automatische modus zonder expliciete inschakeling wilt gebruikenecho 'export AWS_PROFILE=default' >> ~/.bashrcecho 'export AWS_REGION=us-east-1' >> ~/.bashrcsource ~/.bashrc # 5. Controleren of modellen zijn gedetecteerdopenclaw models listGeavanceerde configuratie
Inferentieprofielen
OpenClaw detecteert regionale en globale inferentieprofielen naast
basismodellen. Wanneer een profiel aan een bekend basismodel is gekoppeld,
neemt het profiel de mogelijkheden van dat model over (contextvenster, maximaal aantal tokens,
redeneren, beeldverwerking) en wordt automatisch de juiste Bedrock-aanvraagregio
ingevoegd. Hierdoor werken Claude-profielen voor meerdere regio's zonder handmatige
provideroverschrijvingen. Globale profielen voor meerdere regio's (global.*) worden
als eerste weergegeven in openclaw models list, omdat ze doorgaans meer capaciteit
en automatische failover bieden.
ID's van inferentieprofielen zien eruit als us.anthropic.claude-opus-4-6-v1:0 (regionaal)
of anthropic.claude-opus-4-6-v1:0 (globaal). Als het onderliggende model al
in de detectieresultaten staat, neemt het profiel de volledige reeks mogelijkheden ervan over;
anders worden veilige standaardwaarden toegepast.
Er is geen aanvullende 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 |
Voordeligere verwerking voor werklasten die een hogere latentie kunnen verdragen |
priority |
Verwerking met prioriteit voor latentiegevoelige werklasten |
reserved |
Gereserveerde capaciteit voor werklasten 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", // van toepassing op 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 en Sonnet 5 ondersteunen alleen het niveau default; OpenClaw waarschuwt
en negeert flex, priority of reserved wanneer die voor deze 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). Als u deze fout ziet, controleert
u of het model het aangevraagde niveau ondersteunt.
Temperatuur van Claude Opus 4.7 en 4.8
Bedrock weigert de parameter temperature voor Claude Opus 4.7 en Opus
4.8. OpenClaw laat temperature automatisch weg voor elke overeenkomende
Bedrock-verwijzing, waaronder basismodel-ID's, benoemde inferentieprofielen,
applicatie-inferentieprofielen waarvan het onderliggende model via
bedrock:GetInferenceProfile wordt herleid tot Opus 4.7/4.8, en varianten
van opus-4.7/opus-4.8 met punten en 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 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 Fables contextvenster van 1M, uitvoerlimiet van 128K,
altijd ingeschakeld adaptief denken en ondersteunde toewijzing van
inspanningsniveaus toe. /think off en /think minimal worden toegewezen
aan low; temperatuur en besturingselementen voor gedwongen toolkeuze
worden weggelaten, overeenkomstig de route voor Opus 4.7/4.8. Streaminguitvoer
wordt vastgehouden totdat Bedrock een eindstatus retourneert, zodat weigeringen
tijdens het streamen geen gedeeltelijke tekst vrijgeven.
AWS vereist een expliciete opt-in voor gegevensbewaring via
provider_data_share voordat Fable beschikbaar is. Prompts en aanvullingen
worden gedeeld met Anthropic en maximaal 30 dagen bewaard voor vertrouwen
en veiligheid. Controleer en configureer
Bedrock-gegevensbewaring
voordat u 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 basismodel
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, beeldinvoer, promptcaching, veilig streamen bij weigeringen
en ingebouwde inspanningsniveaus toe. Adaptief denken is altijd ingeschakeld:
/think off en /think minimal worden toegewezen aan low, terwijl xhigh
en max beschikbaar blijven. Aangepaste steekproefwaarden en waarden voor
gedwongen toolkeuze worden weggelaten.
Claude Sonnet 5
AWS documenteert Sonnet 5 voor zowel de
bedrock-runtime- als bedrock-mantle-eindpunten.
OpenClaw herkent het Bedrock-basismodel
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, beeldinvoer,
ingebouwde 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 waarden
voor temperatuur en gedwongen toolkeuze worden weggelaten zolang adaptief
denken actief is.
Beveiligingsregels
U kunt Amazon Bedrock Guardrails
toepassen op alle aanroepen van Bedrock-modellen door een guardrail-object
toe te voegen aan de configuratie van de Plugin amazon-bedrock.
Beveiligingsregels stellen u in staat inhoudsfiltering, weigering van
onderwerpen, woordfilters, filters voor gevoelige informatie en controles
op contextuele onderbouwing af te dwingen.
{ 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 en guardrailVersion zijn vereist.
| Optie | Beschrijving |
|---|---|
guardrailIdentifier |
ID van de beveiligingsregel (bijvoorbeeld abc123) of volledige ARN (bijvoorbeeld arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123). |
guardrailVersion |
Nummer van de gepubliceerde versie, 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 het in op "disabled" voor productie. |
Embeddings voor geheugendoorzoeking
Bedrock kan ook dienen als embeddingprovider voor
geheugendoorzoeking. Dit wordt afzonderlijk van de
inferentieprovider geconfigureerd: stel agents.defaults.memorySearch.provider
in op "bedrock":
{ agents: { defaults: { memorySearch: { provider: "bedrock", model: "amazon.titan-embed-text-v2:0", // default }, }, },}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 Configuratiereferentie voor geheugen -- Bedrock voor de volledige modellenlijst en dimensieopties.
Opmerkingen en aandachtspunten
- Voor Bedrock moet modeltoegang zijn ingeschakeld in uw AWS-account/regio.
- Automatische detectie vereist de machtigingen
bedrock:ListFoundationModelsenbedrock:ListInferenceProfiles. - Als u de automatische modus gebruikt, stelt u op de Gateway-host een van de
ondersteunde AWS-omgevingsmarkeringen voor authenticatie in. Als u de voorkeur
geeft aan IMDS-/gedeelde-configuratie-authenticatie zonder omgevingsmarkeringen,
stelt u
plugins.entries.amazon-bedrock.config.discovery.enabled: truein. - OpenClaw toont de bron van de referenties in deze volgorde:
AWS_BEARER_TOKEN_BEDROCK, vervolgensAWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY, daarnaAWS_PROFILEen ten slotte de standaard AWS SDK-keten. - Ondersteuning voor redeneren hangt af van het model; raadpleeg de Bedrock-modelkaart voor de huidige mogelijkheden.
- Als u de voorkeur geeft aan een beheerde sleutelprocedure, kunt u ook een OpenAI-compatibele proxy vóór Bedrock plaatsen en deze in plaats daarvan configureren als OpenAI-provider.
Gerelateerd
Providers, modelverwijzingen en failovergedrag kiezen.
Bedrock-embeddings configureren voor geheugendoorzoeking.
Volledige lijst met Bedrock-embeddingmodellen en dimensieopties.
Algemene probleemoplossing en veelgestelde vragen.