Amazon Bedrock w OpenClaw — modele AI na infrastrukturze AWS

Przeglad

OpenClaw integruje sie z Amazon Bedrock za posrednictwem dostawcy strumieniowego Bedrock Converse, korzystajac z poswiadczen AWS SDK zamiast kluczy API. To idealne rozwiazanie dla organizacji, ktore juz korzystaja z infrastruktury AWS i chca zachowac pelna kontrole nad przeplywem danych.

Szczegoly dostawcy

• Identyfikator: amazon-bedrock
• API: bedrock-converse-stream
• Uwierzytelnianie: lancuch poswiadczen AWS (zmienne srodowiskowe, wspolna konfiguracja lub role instancji EC2)
• Domyslny region: us-east-1 (konfigurowalny przez AWS_REGION lub AWS_DEFAULT_REGION)

Automatyczne wykrywanie modeli

OpenClaw moze automatycznie odkrywac modele Bedrock obslugujace streaming, korzystajac z API bedrock:ListFoundationModels i bedrock:ListInferenceProfiles. Wyniki sa cachowane z domyslnym odswiezaniem co godzine.

Dostawca aktywuje sie automatycznie, gdy wykryje znaczniki uwierzytelniania AWS (AWS_BEARER_TOKEN_BEDROCK, AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY lub AWS_PROFILE).

Dla hostow opartych na IMDS bez zmiennych srodowiskowych, wlacz jawnie:

plugins.entries.amazon-bedrock.config.discovery.enabled: true

Opcje konfiguracji wykrywania

• discovery.enabled — tryb automatycznego wlaczania
• discovery.region — region AWS do wykrywania
• discovery.providerFilter — filtrowanie po dostawcy (np. "anthropic" lub "amazon")
• discovery.refreshInterval — czas cache w sekundach (0 wylacza cache)
• discovery.defaultContextWindow — domyslnie 32 000 tokenow
• discovery.defaultMaxTokens — domyslnie 4 096 tokenow

Podstawowa konfiguracja

Zmienne srodowiskowe

export AWS_ACCESS_KEY_ID="AKIA..."
export AWS_SECRET_ACCESS_KEY="..."
export AWS_REGION="us-east-1"
export AWS_SESSION_TOKEN="..."       # Opcjonalne
export AWS_PROFILE="your-profile"    # Opcjonalne

Konfiguracja OpenClaw

{
  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"],
          contextWindow: 200000,
          maxTokens: 8192
        }]
      }
    }
  },
  agents: {
    defaults: {
      model: {
        primary: "amazon-bedrock/us.anthropic.claude-opus-4-6-v1:0"
      }
    }
  }
}

Konfiguracja roli EC2

Dla instancji EC2 z rolami IAM, uwierzytelnianie IMDS odbywa sie automatycznie.

Wymagane uprawnienia IAM

• bedrock:InvokeModel
• bedrock:InvokeModelWithResponseStream
• bedrock:ListFoundationModels
• bedrock:ListInferenceProfiles

Alternatywnie mozesz przypisac zarzadzana polityke AmazonBedrockFullAccess.

Szybka konfiguracja na EC2

# Wlacz wykrywanie jawnie na instancji
openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled true
openclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1

Profile inferencyjne

OpenClaw wykrywa zarowno profile regionalne (np. us.anthropic.claude-opus-4-6-v1:0), jak i globalne (np. anthropic.claude-opus-4-6-v1:0). Automatycznie dziedzicza one mozliwosci z bazowych modeli, umozliwiajac korzystanie z Claude w roznych regionach bez recznych nadpisywan.

Guardrails (barierki ochronne)

Zastosuj filtrowanie tresci i weryfikacje kontekstualna za pomoca Amazon Bedrock Guardrails:

{
  guardrail: {
    guardrailIdentifier: "abc123",
    guardrailVersion: "1",
    streamProcessingMode: "sync",
    trace: "enabled"
  }
}

Wymaga uprawnienia IAM bedrock:ApplyGuardrail.

Embeddingi do wyszukiwania pamieci

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "bedrock",
        model: "amazon.titan-embed-text-v2:0"
      }
    }
  }
}

Obslugiwane modele embedddingow: Titan Embed, Amazon Nova Embed, Cohere Embed i TwelveLabs Marengo.