Providers
Amazon Bedrock
OpenClaw kann Modelle von Amazon Bedrock über seinen Streaming-Provider Bedrock Converse verwenden. Die Bedrock-Authentifizierung verwendet die Standard-Anmeldedatenkette des AWS SDK, keinen API-Schlüssel.
| Eigenschaft | Wert |
|---|---|
| Provider | amazon-bedrock |
| API | bedrock-converse-stream |
| Authentifizierung | AWS-Anmeldedaten (Umgebungsvariablen, gemeinsame Konfiguration oder Instanzrolle) |
| Region | AWS_REGION oder AWS_DEFAULT_REGION (Standard: us-east-1) |
Erste Schritte
Wählen Sie Ihre bevorzugte Authentifizierungsmethode und führen Sie die Einrichtungsschritte aus.
Zugriffsschlüssel/Umgebungsvariablen
Am besten geeignet für: Entwicklerrechner, CI oder Hosts, auf denen Sie AWS-Anmeldedaten direkt verwalten.
AWS-Anmeldedaten auf dem Gateway-Host festlegen
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-Schlüssel/Bearer-Token):export AWS_BEARER_TOKEN_BEDROCK="..."Bedrock-Provider und Modell zur Konfiguration hinzufügen
Es ist kein apiKey erforderlich. Konfigurieren Sie den Provider mit 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" }, }, },}Verfügbarkeit der Modelle überprüfen
openclaw models listEC2-Instanzrollen (IMDS)
Am besten geeignet für: EC2-Instanzen mit einer zugewiesenen IAM-Rolle, die den Instanzmetadatendienst zur Authentifizierung verwenden.
Erkennung ausdrücklich aktivieren
Bei Verwendung von IMDS kann OpenClaw die AWS-Authentifizierung nicht allein anhand von Umgebungsmarkern erkennen. Daher müssen Sie sie ausdrücklich aktivieren:
openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1Optional einen Umgebungsmarker für den automatischen Modus hinzufügen
Wenn auch die automatische Erkennung über Umgebungsmarker funktionieren soll, beispielsweise für Oberflächen von openclaw status:
export AWS_PROFILE=defaultexport AWS_REGION=us-east-1Sie benötigen keinen fingierten API-Schlüssel.
Erkennung der Modelle überprüfen
openclaw models listAutomatische Modellerkennung
OpenClaw kann Bedrock-Modelle automatisch erkennen, die Streaming
und Textausgabe unterstützen. Die Erkennung verwendet bedrock:ListFoundationModels und
bedrock:ListInferenceProfiles; die Ergebnisse werden zwischengespeichert (Standard: 1 Stunde).
So wird der implizite Provider aktiviert:
- Wenn
plugins.entries.amazon-bedrock.config.discovery.enabledauftruegesetzt ist, versucht OpenClaw die Erkennung auch dann, wenn kein AWS-Umgebungsmarker vorhanden ist. - Wenn
plugins.entries.amazon-bedrock.config.discovery.enablednicht gesetzt ist, fügt OpenClaw den impliziten Bedrock-Provider nur dann automatisch hinzu, wenn einer dieser AWS-Authentifizierungsmarker vorhanden ist:AWS_BEARER_TOKEN_BEDROCK,AWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEYoderAWS_PROFILE. - Der eigentliche Authentifizierungspfad der Bedrock-Laufzeit verwendet weiterhin die
Standardkette des AWS SDK. Daher können gemeinsame Konfiguration, SSO und die
Authentifizierung über IMDS-Instanzrollen auch dann funktionieren, wenn für die Erkennung
eine ausdrückliche Aktivierung mit
enabled: trueerforderlich war.
Konfigurationsoptionen für die Erkennung
Die Konfigurationsoptionen befinden sich unter 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 | Standard | Beschreibung |
|---|---|---|
enabled |
automatisch | Im automatischen Modus aktiviert OpenClaw den impliziten Bedrock-Provider nur, wenn ein unterstützter AWS-Umgebungsmarker vorhanden ist. Setzen Sie den Wert auf true, um die Erkennung zu erzwingen. |
region |
AWS_REGION / AWS_DEFAULT_REGION / us-east-1 |
AWS-Region für API-Aufrufe zur Erkennung. |
providerFilter |
(alle) | Gleicht Namen von Bedrock-Providern ab, beispielsweise anthropic und amazon. |
refreshInterval |
3600 |
Cache-Dauer in Sekunden. Setzen Sie den Wert auf 0, um die Zwischenspeicherung zu deaktivieren. |
defaultContextWindow |
32000 |
Kontextfenster für erkannte Modelle ohne bekannte Token-Grenzen. Überschreiben Sie den Wert, wenn Ihnen die Grenzen Ihres Modells bekannt sind. |
defaultMaxTokens |
4096 |
Maximale Anzahl an Ausgabe-Token für erkannte Modelle ohne bekannte Token-Grenzen. Überschreiben Sie den Wert, wenn Ihnen die Grenzen Ihres Modells bekannt sind. |
Kontextfenster und Grenzen für die maximale Token-Anzahl
Die Bedrock-APIs ListFoundationModels und GetFoundationModel geben keine
Metadaten zu Token-Grenzen zurück, sondern nur Modell-ID, Name, Modalitäten und
Lebenszyklusstatus. OpenClaw enthält eine Nachschlagetabelle mit bekannten Kontextfenstern
und Ausgabegrenzen für verbreitete Bedrock-Modelle (Claude, Nova, Llama, Mistral, DeepSeek
und weitere), damit Sitzungsverwaltung, Compaction-Schwellenwerte und
die Erkennung von Kontextüberläufen für diese Modelle korrekt funktionieren.
Erkannte Modelle, die nicht in der Tabelle enthalten sind, verwenden ersatzweise
defaultContextWindow und defaultMaxTokens. Wenn für ein von Ihnen verwendetes Modell
keine genauen Grenzen vorhanden sind, überschreiben Sie diese mit einem ausdrücklichen
Eintrag unter models.providers["amazon-bedrock"].models.
Schnelleinrichtung (AWS-Pfad)
Diese Anleitung erstellt eine IAM-Rolle, weist Bedrock-Berechtigungen zu, verknüpft das Instanzprofil und aktiviert die OpenClaw-Erkennung auf dem EC2-Host.
# 1. IAM-Rolle und Instanzprofil erstellenaws 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. Ihrer EC2-Instanz zuweisenaws ec2 associate-iam-instance-profile \ --instance-id i-xxxxx \ --iam-instance-profile Name=EC2-Bedrock-Access # 3. Auf der EC2-Instanz die Erkennung ausdrücklich aktivierenopenclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1 # 4. Optional: Umgebungsmarker hinzufügen, wenn Sie den automatischen Modus ohne ausdrückliche Aktivierung verwenden möchtenecho 'export AWS_PROFILE=default' >> ~/.bashrcecho 'export AWS_REGION=us-east-1' >> ~/.bashrcsource ~/.bashrc # 5. Erkennung der Modelle überprüfenopenclaw models listErweiterte Konfiguration
Inferenzprofile
OpenClaw erkennt neben Basismodellen auch regionale und globale Inferenzprofile.
Wenn ein Profil einem bekannten Basismodell zugeordnet ist, übernimmt das Profil
dessen Fähigkeiten (Kontextfenster, maximale Token-Anzahl, logisches Schlussfolgern,
Bildverarbeitung), und die richtige Bedrock-Anfrageregion wird automatisch eingefügt.
Dadurch funktionieren regionsübergreifende Claude-Profile ohne manuelle
Provider-Überschreibungen. Globale regionsübergreifende Profile (global.*) werden
in openclaw models list zuerst aufgeführt, da sie in der Regel mehr Kapazität und
einen automatischen Failover bieten.
IDs von Inferenzprofilen sehen beispielsweise wie us.anthropic.claude-opus-4-6-v1:0
(regional) oder anthropic.claude-opus-4-6-v1:0 (global) aus. Wenn das zugrunde liegende
Modell bereits in den Erkennungsergebnissen enthalten ist, übernimmt das Profil dessen
vollständigen Funktionsumfang. Andernfalls gelten sichere Standardwerte.
Es ist keine zusätzliche Konfiguration erforderlich. Solange die Erkennung aktiviert ist
und der IAM-Prinzipal über bedrock:ListInferenceProfiles verfügt, werden Profile neben
Basismodellen in openclaw models list angezeigt.
Dienststufe
Einige Bedrock-Modelle unterstützen den Parameter service_tier, um Kosten
oder Latenz zu optimieren. Folgende Stufen sind verfügbar:
| Stufe | Beschreibung |
|---|---|
default |
Standardstufe von Bedrock |
flex |
Vergünstigte Verarbeitung für Arbeitslasten, die eine höhere Latenz tolerieren können |
priority |
Priorisierte Verarbeitung für latenzempfindliche Arbeitslasten |
reserved |
Reservierte Kapazität für Arbeitslasten im Dauerbetrieb |
Legen Sie serviceTier (oder service_tier) über agents.defaults.params für
Anfragen an Bedrock-Modelle oder modellspezifisch unter
agents.defaults.models["<model-key>"].params fest:
{ agents: { defaults: { params: { serviceTier: "flex", // applies to all models }, models: { "amazon-bedrock/mistral.mistral-large-3-675b-instruct": { params: { serviceTier: "priority", // per-model override }, }, }, }, },}Gültige Werte sind default, flex, priority und reserved. Claude
Fable 5 und Sonnet 5 unterstützen nur die Stufe default; OpenClaw warnt
und ignoriert für diese Modelle angeforderte Werte wie flex, priority
oder reserved. Bei anderen Modellen unterstützt nicht jedes Modell jede
Stufe. Eine nicht unterstützte Stufe führt zu einem Bedrock-Validierungsfehler,
dessen Fehlermeldung irreführend sein kann (beispielsweise „Die angegebene
Modellkennung ist ungültig“, anstatt die Stufe als Problem zu benennen).
Wenn dieser Fehler auftritt, prüfen Sie, ob das Modell die angeforderte
Stufe unterstützt.
Claude Opus 4.7 and 4.8 temperature
Bedrock lehnt den Parameter temperature für Claude Opus 4.7 und Opus
4.8 ab. OpenClaw lässt temperature bei jeder passenden Bedrock-Referenz
automatisch weg, einschließlich Foundation-Model-IDs, benannter
Inferenzprofile, Anwendungsinferenzprofile, deren zugrunde liegendes Modell
über bedrock:GetInferenceProfile zu Opus 4.7/4.8 aufgelöst wird, sowie
punktierter Varianten von opus-4.7/opus-4.8 mit optionalen
Regionspräfixen (us., eu., ap., apac., au., jp., global.).
Es ist keine Konfigurationsoption erforderlich, und das Weglassen gilt
sowohl für das Objekt mit den Anfrageoptionen als auch für das
Nutzlastfeld inferenceConfig.
Claude Fable 5
Verwenden Sie amazon-bedrock/anthropic.claude-fable-5 in us-east-1
oder regionale Inferenz-IDs wie us.anthropic.claude-fable-5.
OpenClaw wendet das Kontextfenster von Fable mit 1 Million Token, das
Ausgabelimit von 128.000 Token, stets aktives adaptives Denken und die
unterstützte Zuordnung der Aufwandsstufen an. /think off und
/think minimal werden low zugeordnet; Temperatur und Steuerelemente
für die erzwungene Werkzeugauswahl werden entsprechend dem Pfad für
Opus 4.7/4.8 weggelassen. Die Streaming-Ausgabe wird zurückgehalten, bis
Bedrock einen Endstatus zurückgibt, damit Ablehnungen während des Streams
keinen Teiltext offenlegen.
AWS verlangt eine ausdrückliche Einwilligung zur Datenspeicherung über
provider_data_share, bevor Fable verfügbar ist. Eingaben und
Vervollständigungen werden mit Anthropic geteilt und für Vertrauens- und
Sicherheitszwecke bis zu 30 Tage gespeichert. Prüfen und konfigurieren Sie
die Datenspeicherung von Bedrock,
bevor Sie das Modell aktivieren.
Claude Mythos 5
Claude Mythos 5 ist über Bedrock nur für Konten mit der erforderlichen
Genehmigung für eingeschränkten Zugriff verfügbar. OpenClaw erkennt das
Foundation Model anthropic.claude-mythos-5 sowie regionale oder globale
Inferenzprofile wie us.anthropic.claude-mythos-5.
OpenClaw wendet das Kontextfenster mit 1.000.000 Token, das Ausgabelimit
von 128.000 Token, Bildeingaben, Prompt-Caching, ablehnungssicheres
Streaming und native Aufwandsstufen an. Adaptives Denken ist stets
aktiviert: /think off und /think minimal werden low zugeordnet,
während xhigh und max weiterhin verfügbar sind. Benutzerdefinierte
Sampling-Werte und Werte für die erzwungene Werkzeugauswahl werden
weggelassen.
Claude Sonnet 5
AWS dokumentiert Sonnet 5 sowohl für die Endpunkte
bedrock-runtime als auch bedrock-mantle.
OpenClaw erkennt das Bedrock Foundation Model
anthropic.claude-sonnet-5 sowie regionale oder globale Inferenzprofile
wie us.anthropic.claude-sonnet-5. Es wendet das Kontextfenster mit
1.000.000 Token, das Ausgabelimit von 128.000 Token, Bildeingaben, native
Aufwandsstufen, Prompt-Caching und ablehnungssicheres Streaming an.
Bedrock lässt adaptives Denken für Sonnet 5 aktiviert. OpenClaw verwendet
standardmäßig high; /think off und /think minimal werden low
zugeordnet, da dieser Pfad das Denken nicht deaktivieren kann.
Benutzerdefinierte Temperaturwerte und Werte für die erzwungene
Werkzeugauswahl werden weggelassen, solange adaptives Denken aktiv ist.
Guardrails
Sie können Amazon Bedrock Guardrails
auf alle Bedrock-Modellaufrufe anwenden, indem Sie der Konfiguration des
Plugins amazon-bedrock ein guardrail-Objekt hinzufügen. Mit Guardrails
können Sie Inhaltsfilterung, Themenblockierung, Wortfilter, Filter für
sensible Informationen und Prüfungen der kontextbezogenen Fundierung
durchsetzen.
{ 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 und guardrailVersion sind erforderlich.
| Option | Beschreibung |
|---|---|
guardrailIdentifier |
Guardrail-ID (z. B. abc123) oder vollständiger ARN (z. B. arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123). |
guardrailVersion |
Veröffentlichte Versionsnummer oder "DRAFT" für den Arbeitsentwurf. |
streamProcessingMode |
"sync" oder "async" für die Guardrail-Auswertung während des Streamings. Wenn die Option weggelassen wird, verwendet Bedrock seinen Standardwert. |
trace |
"enabled" oder "enabled_full" zur Fehlerdiagnose; für den Produktivbetrieb weglassen oder auf "disabled" setzen. |
Embeddings for memory search
Bedrock kann auch als Embedding-Provider für die
Speichersuche dienen. Dies wird getrennt vom
Inferenz-Provider konfiguriert: Setzen Sie agents.defaults.memorySearch.provider
auf "bedrock":
{ agents: { defaults: { memorySearch: { provider: "bedrock", model: "amazon.titan-embed-text-v2:0", // default }, }, },}Bedrock-Embeddings verwenden dieselbe AWS-SDK-Anmeldedatenkette wie die Inferenz (Instanzrollen, SSO, Zugriffsschlüssel, gemeinsame Konfiguration und Webidentität). Es ist kein API-Schlüssel erforderlich.
Zu den unterstützten Embedding-Modellen gehören Amazon Titan Embed (v1, v2), Amazon Nova Embed, Cohere Embed (v3, v4) und TwelveLabs Marengo. Die vollständige Modellliste und die Dimensionsoptionen finden Sie in der Referenz zur Speicherkonfiguration – Bedrock.
Notes and caveats
- Für Bedrock muss der Modellzugriff in Ihrem AWS-Konto und Ihrer AWS-Region aktiviert sein.
- Die automatische Erkennung benötigt die Berechtigungen
bedrock:ListFoundationModelsundbedrock:ListInferenceProfiles. - Wenn Sie den automatischen Modus verwenden, setzen Sie auf dem
Gateway-Host eine der unterstützten AWS-Umgebungsmarkierungen für die
Authentifizierung. Wenn Sie die Authentifizierung über IMDS oder eine
gemeinsame Konfiguration ohne Umgebungsmarkierungen bevorzugen, setzen
Sie
plugins.entries.amazon-bedrock.config.discovery.enabled: true. - OpenClaw zeigt die Quelle der Anmeldedaten in dieser Reihenfolge an:
AWS_BEARER_TOKEN_BEDROCK, danachAWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY, danachAWS_PROFILEund schließlich die standardmäßige AWS-SDK-Kette. - Die Unterstützung für Schlussfolgerungen hängt vom Modell ab; prüfen Sie die Bedrock-Modellkarte auf aktuelle Funktionen.
- Wenn Sie einen verwalteten Schlüsselablauf bevorzugen, können Sie auch einen OpenAI-kompatiblen Proxy vor Bedrock schalten und ihn stattdessen als OpenAI-Provider konfigurieren.
Verwandte Themen
Auswahl von Providern, Modellreferenzen und Failover-Verhalten.
Bedrock-Embeddings für die Konfiguration der Speichersuche.
Vollständige Liste der Bedrock-Embedding-Modelle und Dimensionsoptionen.
Allgemeine Fehlerbehebung und häufig gestellte Fragen.