Providers

Amazon Bedrock

OpenClaw kann Amazon Bedrock-Modelle über seinen Streaming-Provider Bedrock Converse verwenden. Die Bedrock-Authentifizierung verwendet die standardmäßige AWS-SDK-Anmeldedatenkette, 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: Entwicklungsrechner, CI oder Hosts, auf denen Sie AWS-Anmeldedaten direkt verwalten.

  • AWS-Anmeldedaten auf dem Gateway-Host festlegen

    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-Schlüssel/Bearer-Token):export AWS_BEARER_TOKEN_BEDROCK="..."
  • Einen Bedrock-Provider und ein Modell zur Konfiguration hinzufügen

    Es ist kein apiKey erforderlich. Konfigurieren Sie den Provider mit 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",            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" },    },  },}
  • Verfügbarkeit der Modelle überprüfen

    bash
    openclaw models list
  • EC2-Instanzrollen (IMDS)

    Am besten geeignet für: EC2-Instanzen mit einer zugewiesenen IAM-Rolle, die den Instanzmetadatendienst zur Authentifizierung verwenden.

  • Erkennung explizit aktivieren

    Bei Verwendung von IMDS kann OpenClaw die AWS-Authentifizierung nicht allein anhand von Umgebungsmarkern erkennen. Daher müssen Sie sie ausdrücklich aktivieren:

    bash
    openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1
  • Optional einen Umgebungsmarker für den automatischen Modus hinzufügen

    Wenn auch der Pfad zur automatischen Erkennung über Umgebungsmarker funktionieren soll (beispielsweise für openclaw status-Oberflächen):

    bash
    export AWS_PROFILE=defaultexport AWS_REGION=us-east-1

    Sie benötigen keinen vorgetäuschten API-Schlüssel.

  • Erkennung der Modelle überprüfen

    bash
    openclaw models list
  • Automatische Modellerkennung

    OpenClaw kann Bedrock-Modelle, die Streaming und Textausgabe unterstützen, automatisch erkennen. 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.enabled auf true gesetzt ist, versucht OpenClaw die Erkennung auch dann, wenn kein AWS-Umgebungsmarker vorhanden ist.
    • Wenn plugins.entries.amazon-bedrock.config.discovery.enabled nicht gesetzt ist, fügt OpenClaw den impliziten Bedrock-Provider nur dann automatisch hinzu, wenn einer dieser AWS-Authentifizierungsmarker erkannt wird: AWS_BEARER_TOKEN_BEDROCK, AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY oder AWS_PROFILE.
    • Der tatsächliche Bedrock-Laufzeitpfad für die Authentifizierung verwendet weiterhin die standardmäßige AWS-SDK-Kette. Daher können gemeinsame Konfiguration, SSO und die Authentifizierung über eine IMDS-Instanzrolle auch dann funktionieren, wenn für die Erkennung enabled: true zur ausdrücklichen Aktivierung erforderlich war.
    Konfigurationsoptionen für die Erkennung

    Die Konfigurationsoptionen befinden sich unter 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 Standard Beschreibung
    enabled automatisch Im automatischen Modus aktiviert OpenClaw den impliziten Bedrock-Provider nur, wenn ein unterstützter AWS-Umgebungsmarker erkannt wird. Setzen Sie true, um die Erkennung zu erzwingen.
    region AWS_REGION / AWS_DEFAULT_REGION / us-east-1 Für API-Aufrufe zur Erkennung verwendete AWS-Region.
    providerFilter (alle) Gleicht Namen von Bedrock-Providern ab (beispielsweise anthropic, 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-Limits (überschreiben Sie den Wert, wenn Ihnen die Limits Ihres Modells bekannt sind).
    defaultMaxTokens 4096 Maximale Anzahl an Ausgabe-Token für erkannte Modelle ohne bekannte Token-Limits (überschreiben Sie den Wert, wenn Ihnen die Limits Ihres Modells bekannt sind).
    Kontextfenster und maximale Token-Limits

    Die Bedrock-APIs ListFoundationModels und GetFoundationModel geben keine Metadaten zu Token-Limits zurück, sondern nur Modell-ID, Name, Modalitäten und Lebenszyklusstatus. OpenClaw enthält eine Nachschlagetabelle mit bekannten Kontextfenstern und Ausgabelimits 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 Limits vorliegen, überschreiben Sie diese mit einem expliziten models.providers["amazon-bedrock"].models-Eintrag.

    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.

    bash
    # 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 explizit 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 explizite Aktivierung verwenden möchtenecho 'export AWS_PROFILE=default' >> ~/.bashrcecho 'export AWS_REGION=us-east-1' >> ~/.bashrcsource ~/.bashrc # 5. Erkennung der Modelle überprüfenopenclaw models list

    Erweiterte Konfiguration

    Inferenzprofile

    OpenClaw erkennt neben Basismodellen auch regionale und globale Inferenzprofile. Wenn ein Profil einem bekannten Basismodell zugeordnet ist, übernimmt das Profil die Fähigkeiten dieses Modells (Kontextfenster, maximale Token-Anzahl, Schlussfolgerung, Bildverarbeitung), und die korrekte 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 im Allgemeinen eine bessere Kapazität und automatisches Failover bieten.

    IDs von Inferenzprofilen sehen beispielsweise wie us.anthropic.claude-opus-4-6-v1 (regional) oder anthropic.claude-opus-4-6-v1 (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, erscheinen die Profile neben den Basismodellen in openclaw models list.

    Dienststufe

    Einige Bedrock-Modelle unterstützen einen Parameter service_tier, um Kosten oder Latenz zu optimieren. Die folgenden Stufen sind verfügbar:

    Stufe Beschreibung
    default Bedrock-Standardstufe
    flex Vergünstigte Verarbeitung für Arbeitslasten, die eine längere Latenz tolerieren können
    priority Priorisierte Verarbeitung für latenzempfindliche Arbeitslasten
    reserved Reservierte Kapazität für Arbeitslasten im stationären Betrieb

    Legen Sie serviceTier (oder service_tier) über agents.defaults.params für Bedrock-Modellanfragen oder modellspezifisch in agents.defaults.models["<model-key>"].params fest:

    json5
    {  agents: {    defaults: {      params: {        serviceTier: "flex", // gilt für alle Modelle      },      models: {        "amazon-bedrock/mistral.mistral-large-3-675b-instruct": {          params: {            serviceTier: "priority", // modellspezifische Überschreibung          },        },      },    },  },}

    Gültige Werte sind default, flex, priority und reserved. Claude Fable 5, Opus 5 und Sonnet 5 unterstützen nur die Stufe default; OpenClaw warnt und ignoriert flex, priority oder reserved, wenn diese für jene Modelle angefordert werden. Bei anderen Modellen unterstützt nicht jedes Modell jede Stufe – eine nicht unterstützte Stufe führt zu einem Bedrock-Validierungsfehler, und die Fehlermeldung kann irreführend sein (zum Beispiel „Die angegebene Modellkennung ist ungültig“, statt die Stufe als Problem zu benennen). Wenn dieser Fehler auftritt, prüfen Sie, ob das Modell die angeforderte Stufe unterstützt.

    Temperatur bei Claude Opus 5, 4.8 und 4.7

    Bedrock lehnt den Parameter temperature für Claude Opus 5, Opus 4.8 und Opus 4.7 ab. OpenClaw lässt temperature automatisch für jede passende Bedrock- Referenz weg, einschließlich Foundation-Modell-IDs, benannter Inferenzprofile, Anwendungs- Inferenzprofile, deren zugrunde liegendes Modell über bedrock:GetInferenceProfile zu Opus 5/4.8/4.7 aufgelöst wird, sowie gepunkteter 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 Opus 5

    Verwenden Sie amazon-bedrock/anthropic.claude-opus-5 am Bedrock-Endpunkt der Messages-API oder ein regionales/globales Inferenzprofil wie global.anthropic.claude-opus-5, wenn es in der Bedrock-Erkennung erscheint. OpenClaw wendet das Kontextfenster mit 1.000.000 Token, das Ausgabelimit von 128.000 Token, Bildeingaben, Prompt-Caching, ablehnungssicheres Streaming und native Aufwandsstufen für xhigh/max an.

    Adaptives Denken verwendet standardmäßig high. /think off deaktiviert das Denken, während /think xhigh|max adaptives Denken aktiviert lässt. OpenClaw lässt benutzerdefinierte Sampling-Parameter und nicht unterstützte, vom Standard abweichende Dienststufen weg.

    Claude Fable 5

    Verwenden Sie amazon-bedrock/anthropic.claude-fable-5 in us-east-1 oder die regionalen Inferenz-IDs wie us.anthropic.claude-fable-5. OpenClaw wendet Fables 1M-Kontextfenster, das 128K-Ausgabelimit, stets aktives adaptives Denken und die unterstützte Aufwandszuordnung an. /think off und /think minimal werden low zugeordnet; Temperatur und Steuerelemente für eine erzwungene Tool-Auswahl werden entsprechend der Route für Opus 4.7/4.8 weggelassen. Die Streaming-Ausgabe wird zurückgehalten, bis Bedrock einen endgültigen Status zurückgibt, damit Ablehnungen während des Streamings keinen unvollständigen Text offenlegen.

    AWS erfordert eine ausdrückliche Einwilligung zur Datenspeicherung über provider_data_share, bevor Fable verfügbar ist. Prompts und Vervollständigungen werden mit Anthropic geteilt und für Vertrauens- und Sicherheitszwecke bis zu 30 Tage gespeichert. Prüfen und konfigurieren Sie die Bedrock-Datenspeicherung, bevor Sie das Modell aktivieren.

    Claude Mythos 5

    Claude Mythos 5 ist über Bedrock nur für Konten verfügbar, die über die erforderliche Genehmigung für eingeschränkten Zugriff verfügen. OpenClaw erkennt das Foundation-Modell 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 immer aktiviert: /think off und /think minimal werden low zugeordnet, während xhigh und max weiterhin verfügbar sind. Benutzerdefiniertes Sampling und Werte für eine erzwungene Tool-Auswahl 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-Modell anthropic.claude-sonnet-5 und 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, weil sich das Denken über diese Route nicht deaktivieren lässt. Benutzerdefinierte Temperaturwerte und Werte für eine erzwungene Tool-Auswahl werden weggelassen, solange adaptives Denken aktiv ist.

    Schutzmechanismen

    Sie können Amazon Bedrock Guardrails auf alle Bedrock-Modellaufrufe anwenden, indem Sie der Plugin-Konfiguration amazon-bedrock ein Objekt guardrail hinzufügen. Mit Schutzmechanismen können Sie Inhaltsfilterung, die Ablehnung von Themen, Wortfilter, Filter für vertrauliche Informationen und Prüfungen der kontextbezogenen Fundierung durchsetzen.

    json5
    {  plugins: {    entries: {      "amazon-bedrock": {        config: {          guardrail: {            guardrailIdentifier: "abc123", // Schutzmechanismus-ID oder vollständiger ARN            guardrailVersion: "1", // Versionsnummer oder "DRAFT"            streamProcessingMode: "sync", // optional: "sync" oder "async"            trace: "enabled", // optional: "enabled", "disabled" oder "enabled_full"          },        },      },    },  },}

    guardrailIdentifier und guardrailVersion sind erforderlich.

    Option Beschreibung
    guardrailIdentifier Schutzmechanismus-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 Auswertung des Schutzmechanismus während des Streamings. Wenn die Option weggelassen wird, verwendet Bedrock den Standardwert.
    trace "enabled" oder "enabled_full" zur Fehlerdiagnose; für die Produktion weglassen oder auf "disabled" setzen.
    Einbettungen für die Speichersuche

    Bedrock kann auch als Einbettungs-Provider für die Speichersuche dienen. Dies wird getrennt vom Inferenz-Provider konfiguriert – setzen Sie memory.search.provider auf "bedrock":

    json5
    {  memory: {    search: {      provider: "bedrock",      model: "amazon.titan-embed-text-v2:0", // Standardwert    },  },}

    Bedrock-Einbettungen verwenden dieselbe AWS-SDK-Anmeldedatenkette wie die Inferenz (Instanz- rollen, SSO, Zugriffsschlüssel, gemeinsame Konfiguration und Webidentität). Es ist kein API-Schlüssel erforderlich.

    Zu den unterstützten Einbettungsmodellen 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 Konfigurationsreferenz für den Speicher – Bedrock.

    Hinweise und Einschränkungen
    • Bedrock erfordert, dass der Modellzugriff in Ihrem AWS-Konto/Ihrer AWS-Region aktiviert ist.
    • Die automatische Erkennung erfordert die Berechtigungen bedrock:ListFoundationModels und bedrock:ListInferenceProfiles.
    • Wenn Sie den automatischen Modus verwenden, setzen Sie auf dem Gateway-Host eine der unterstützten AWS-Authentifizierungs-Umgebungsmarkierungen. Wenn Sie die IMDS-/gemeinsame-Konfigurationsauthentifizierung 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, dann AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY, dann AWS_PROFILE, dann die standardmäßige AWS-SDK-Kette.
    • Die Unterstützung für logisches Denken hängt vom Modell ab; prüfen Sie die Bedrock-Modellkarte auf aktuelle Funktionen.
    • Wenn Sie einen verwalteten Schlüsselfluss bevorzugen, können Sie auch einen OpenAI-kompatiblen Proxy vor Bedrock schalten und ihn stattdessen als OpenAI-Provider konfigurieren.

    Verwandte Themen

    Was this useful?
    On this page

    On this page