Przejdź do głównej treści
OpenClaw może używać modeli Amazon Bedrock za pośrednictwem swojego dostawcy strumieniowego Bedrock Converse. Uwierzytelnianie Bedrock używa domyślnego łańcucha poświadczeń AWS SDK, a nie klucza API.
WłaściwośćWartość
Dostawcaamazon-bedrock
APIbedrock-converse-stream
UwierzytelnianiePoświadczenia AWS (zmienne env, współdzielona konfiguracja lub rola instancji)
RegionAWS_REGION lub AWS_DEFAULT_REGION (domyślnie: us-east-1)

​
Pierwsze kroki

Wybierz preferowaną metodę uwierzytelniania i wykonaj kroki konfiguracji.
Najlepsze dla: maszyn deweloperskich, CI lub hostów, na których bezpośrednio zarządzasz poświadczeniami AWS.
1

Ustaw poświadczenia AWS na hoście gateway

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 key/bearer token):
export AWS_BEARER_TOKEN_BEDROCK="..."
2

Dodaj dostawcę i model Bedrock do swojej konfiguracji

apiKey nie jest wymagane. Skonfiguruj dostawcę z 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" },
    },
  },
}
3

Sprawdź, czy modele są dostępne

openclaw models list
Przy uwierzytelnianiu przez znaczniki env (AWS_ACCESS_KEY_ID, AWS_PROFILE lub AWS_BEARER_TOKEN_BEDROCK) OpenClaw automatycznie włącza niejawnego dostawcę Bedrock do wykrywania modeli bez dodatkowej konfiguracji.

​
Automatyczne wykrywanie modeli

OpenClaw może automatycznie wykrywać modele Bedrock obsługujące strumieniowanie i wyjście tekstowe. Wykrywanie używa bedrock:ListFoundationModels i bedrock:ListInferenceProfiles, a wyniki są buforowane (domyślnie: 1 godzina). Jak włączany jest niejawny dostawca:
  • Jeśli plugins.entries.amazon-bedrock.config.discovery.enabled ma wartość true, OpenClaw spróbuje wykrywania nawet wtedy, gdy nie ma znacznika env AWS.
  • Jeśli plugins.entries.amazon-bedrock.config.discovery.enabled nie jest ustawione, OpenClaw automatycznie dodaje niejawnego dostawcę Bedrock tylko wtedy, gdy wykryje jeden z tych znaczników uwierzytelniania AWS: AWS_BEARER_TOKEN_BEDROCK, AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY lub AWS_PROFILE.
  • Rzeczywista ścieżka uwierzytelniania środowiska wykonawczego Bedrock nadal używa domyślnego łańcucha AWS SDK, więc współdzielona konfiguracja, SSO i uwierzytelnianie rolą instancji IMDS mogą działać nawet wtedy, gdy wykrywanie wymagało enabled: true, aby wyrazić zgodę.
Dla jawnych wpisów models.providers["amazon-bedrock"] OpenClaw nadal może wcześnie rozwiązać uwierzytelnianie Bedrock przez znaczniki env na podstawie znaczników env AWS, takich jak AWS_BEARER_TOKEN_BEDROCK, bez wymuszania pełnego ładowania uwierzytelniania środowiska wykonawczego. Rzeczywista ścieżka uwierzytelniania wywołań modeli nadal używa domyślnego łańcucha AWS SDK.
Opcje konfiguracji znajdują się pod 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,
          },
        },
      },
    },
  },
}
OpcjaDomyślnieOpis
enabledautoW trybie automatycznym OpenClaw włącza niejawnego dostawcę Bedrock tylko wtedy, gdy wykryje obsługiwany znacznik env AWS. Ustaw true, aby wymusić wykrywanie.
regionAWS_REGION / AWS_DEFAULT_REGION / us-east-1Region AWS używany do wywołań API wykrywania.
providerFilter(wszystkie)Dopasowuje nazwy dostawców Bedrock (na przykład anthropic, amazon).
refreshInterval3600Czas trwania pamięci podręcznej w sekundach. Ustaw 0, aby wyłączyć buforowanie.
defaultContextWindow32000Okno kontekstu używane dla wykrytych modeli (nadpisz, jeśli znasz limity swojego modelu).
defaultMaxTokens4096Maksymalna liczba tokenów wyjściowych używana dla wykrytych modeli (nadpisz, jeśli znasz limity swojego modelu).

​
Szybka konfiguracja (ścieżka AWS)

Ten przewodnik tworzy rolę IAM, podłącza uprawnienia Bedrock, kojarzy profil instancji i włącza wykrywanie OpenClaw na hoście EC2. 
# 1. Create IAM role and instance profile
aws 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-Access
aws iam add-role-to-instance-profile \
  --instance-profile-name EC2-Bedrock-Access \
  --role-name EC2-Bedrock-Access

# 2. Attach to your EC2 instance
aws ec2 associate-iam-instance-profile \
  --instance-id i-xxxxx \
  --iam-instance-profile Name=EC2-Bedrock-Access

# 3. On the EC2 instance, enable discovery explicitly
openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled true
openclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1

# 4. Optional: add an env marker if you want auto mode without explicit enable
echo 'export AWS_PROFILE=default' >> ~/.bashrc
echo 'export AWS_REGION=us-east-1' >> ~/.bashrc
source ~/.bashrc

# 5. Verify models are discovered
openclaw models list

​
Konfiguracja zaawansowana

OpenClaw wykrywa regionalne i globalne profile inferencji obok modeli bazowych. Gdy profil mapuje się na znany model bazowy, profil dziedziczy możliwości tego modelu (okno kontekstu, maksymalną liczbę tokenów, rozumowanie, wizję), a właściwy region żądań Bedrock jest wstrzykiwany automatycznie. Oznacza to, że międzyregionalne profile Claude działają bez ręcznych nadpisań dostawcy.Identyfikatory profili inferencji wyglądają jak us.anthropic.claude-opus-4-6-v1:0 (regionalny) lub anthropic.claude-opus-4-6-v1:0 (globalny). Jeśli model bazowy jest już w wynikach wykrywania, profil dziedziczy pełny zestaw jego możliwości; w przeciwnym razie stosowane są bezpieczne wartości domyślne.Nie jest wymagana dodatkowa konfiguracja. Dopóki wykrywanie jest włączone, a podmiot IAM ma bedrock:ListInferenceProfiles, profile pojawiają się obok modeli bazowych w openclaw models list.
Niektóre modele Bedrock obsługują parametr service_tier, aby optymalizować koszt lub opóźnienie. Dostępne są następujące warstwy:
WarstwaOpis
defaultStandardowa warstwa Bedrock
flexPrzetwarzanie ze zniżką dla obciążeń, które tolerują większe opóźnienie
priorityPriorytetowe przetwarzanie dla obciążeń wrażliwych na opóźnienia
reservedZarezerwowana pojemność dla stabilnych obciążeń
Ustaw serviceTier (lub service_tier) przez agents.defaults.params dla żądań modeli Bedrock albo dla konkretnego modelu w agents.defaults.models["<model-key>"].params:
{
  agents: {
    defaults: {
      params: {
        serviceTier: "flex", // applies to all models
      },
      models: {
        "amazon-bedrock/mistral.mistral-large-3-675b-instruct": {
          params: {
            serviceTier: "priority", // per-model override
          },
        },
      },
    },
  },
}
Prawidłowe wartości to default, flex, priority i reserved. Nie wszystkie modele obsługują wszystkie warstwy — jeśli zostanie zażądana nieobsługiwana warstwa, Bedrock zwróci błąd walidacji. Uwaga: komunikat o błędzie jest nieco mylący; może mówić „The provided model identifier is invalid”, zamiast wskazywać nieobsługiwaną warstwę usługi. Jeśli zobaczysz ten błąd, sprawdź, czy model obsługuje żądaną warstwę.
Bedrock odrzuca parametr temperature dla Claude Opus 4.7. OpenClaw automatycznie pomija temperature dla każdego odwołania Bedrock Opus 4.7, w tym identyfikatorów modeli bazowych, nazwanych profili inferencji, aplikacyjnych profili inferencji, których model bazowy rozwiązuje się do Opus 4.7 przez bedrock:GetInferenceProfile, oraz wariantów z kropką opus-4.7 z opcjonalnymi prefiksami regionu (us., eu., ap., apac., au., jp., global.). Nie jest wymagane żadne pokrętło konfiguracji, a pominięcie dotyczy zarówno obiektu opcji żądania, jak i pola ładunku inferenceConfig.
Użyj amazon-bedrock/anthropic.claude-fable-5 w us-east-1 albo regionalnych identyfikatorów inferencji, takich jak us.anthropic.claude-fable-5. OpenClaw stosuje okno kontekstu Fable 1M, limit wyjścia 128K, zawsze włączone adaptacyjne myślenie oraz obsługiwane mapowanie poziomu wysiłku. /think off i /think minimal mapują się na low; nieobsługiwane ustawienia temperatury i wymuszonego wyboru narzędzia są pomijane. Wyjście strumieniowe jest wstrzymywane, aż Bedrock zwróci stan końcowy, aby odmowy w trakcie strumienia nie ujawniały częściowego tekstu. Fable obsługuje tylko standardowy poziom usługi; OpenClaw ignoruje skonfigurowane poziomy flex, priority i reserved dla tego modelu.AWS wymaga jawnej zgody provider_data_share na przechowywanie danych, zanim Fable będzie dostępny. Prompty i uzupełnienia są udostępniane Anthropic i przechowywane przez maksymalnie 30 dni na potrzeby zaufania i bezpieczeństwa. Przejrzyj i skonfiguruj przechowywanie danych Bedrock przed włączeniem modelu.
Możesz zastosować Amazon Bedrock Guardrails do wszystkich wywołań modeli Bedrock, dodając obiekt guardrail do konfiguracji Pluginu amazon-bedrock. Mechanizmy ochronne pozwalają wymuszać filtrowanie treści, blokowanie tematów, filtry słów, filtry informacji poufnych i kontrole ugruntowania kontekstowego.
{
  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"
          },
        },
      },
    },
  },
}
OpcjaWymaganeOpis
guardrailIdentifierTakIdentyfikator mechanizmu ochronnego (np. abc123) lub pełny ARN (np. arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123).
guardrailVersionTakOpublikowany numer wersji albo "DRAFT" dla wersji roboczej.
streamProcessingModeNie"sync" lub "async" do oceny mechanizmu ochronnego podczas strumieniowania. Jeśli pominięto, Bedrock używa wartości domyślnej.
traceNie"enabled" lub "enabled_full" do debugowania; pomiń albo ustaw "disabled" dla produkcji.
Podmiot IAM używany przez Gateway musi mieć uprawnienie bedrock:ApplyGuardrail oprócz standardowych uprawnień do wywoływania.
Bedrock może także działać jako dostawca osadzeń dla wyszukiwania w pamięci. Konfiguruje się to oddzielnie od dostawcy inferencji — ustaw agents.defaults.memorySearch.provider na "bedrock":
{
  agents: {
    defaults: {
      memorySearch: {
        provider: "bedrock",
        model: "amazon.titan-embed-text-v2:0", // default
      },
    },
  },
}
Osadzenia Bedrock używają tego samego łańcucha poświadczeń AWS SDK co inferencja (role instancji, SSO, klucze dostępu, konfiguracja współdzielona i tożsamość sieciowa). Klucz API nie jest potrzebny. Ustaw jawnie memorySearch.provider: "bedrock", aby używać osadzeń Bedrock.Obsługiwane modele osadzeń obejmują Amazon Titan Embed (v1, v2), Amazon Nova Embed, Cohere Embed (v3, v4) i TwelveLabs Marengo. Zobacz odniesienie konfiguracji pamięci — Bedrock, aby uzyskać pełną listę modeli i opcje wymiarów.
  • Bedrock wymaga włączenia dostępu do modelu na Twoim koncie/regionie AWS.
  • Automatyczne wykrywanie wymaga uprawnień bedrock:ListFoundationModels i bedrock:ListInferenceProfiles.
  • Jeśli polegasz na trybie automatycznym, ustaw jeden z obsługiwanych znaczników środowiskowych uwierzytelniania AWS na hoście Gateway. Jeśli wolisz uwierzytelnianie IMDS/konfiguracją współdzieloną bez znaczników środowiskowych, ustaw plugins.entries.amazon-bedrock.config.discovery.enabled: true.
  • OpenClaw pokazuje źródło poświadczeń w tej kolejności: AWS_BEARER_TOKEN_BEDROCK, następnie AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY, następnie AWS_PROFILE, a potem domyślny łańcuch AWS SDK.
  • Obsługa rozumowania zależy od modelu; sprawdź kartę modelu Bedrock, aby poznać aktualne możliwości.
  • Jeśli wolisz zarządzany przepływ kluczy, możesz także umieścić zgodne z OpenAI proxy przed Bedrock i skonfigurować je zamiast tego jako dostawcę OpenAI.

​
Powiązane

Wybór modelu

Wybieranie dostawców, odwołań do modeli i zachowania przełączania awaryjnego.

Wyszukiwanie w pamięci

Osadzenia Bedrock do konfiguracji wyszukiwania w pamięci.

Odniesienie konfiguracji pamięci

Pełna lista modeli osadzeń Bedrock i opcje wymiarów.

Rozwiązywanie problemów

Ogólne rozwiązywanie problemów i FAQ.