Amazon Bedrock Mantle

OpenClaw zawiera wbudowanego dostawcę Amazon Bedrock Mantle, który łączy się z punktem końcowym Mantle zgodnym z OpenAI. Mantle udostępnia modele open source i modele innych firm (GPT-OSS, Qwen, Kimi, GLM i podobne) przez standardowy interfejs /v1/chat/completions oparty na infrastrukturze Bedrock. Mantle udostępnia również modele Anthropic Claude za pośrednictwem trasy Anthropic Messages.

Właściwość	Wartość
Identyfikator dostawcy	`amazon-bedrock-mantle`
API	`openai-completions` dla wykrytych modeli OSS, `anthropic-messages` dla modeli Claude
Uwierzytelnianie	Jawny `AWS_BEARER_TOKEN_BEDROCK` lub generowanie tokenu okaziciela za pomocą łańcucha poświadczeń IAM
Region domyślny	`us-east-1` (można zastąpić przez `AWS_REGION` lub `AWS_DEFAULT_REGION`)

Pierwsze kroki

Wybierz preferowaną metodę uwierzytelniania i wykonaj kroki konfiguracji.

Explicit bearer token
IAM credentials

Najlepsze rozwiązanie dla: środowisk, w których masz już token okaziciela Mantle.

Set the bearer token on the gateway host

export AWS_BEARER_TOKEN_BEDROCK="..."

Opcjonalnie ustaw region (domyślnie us-east-1):

export AWS_REGION="us-west-2"

Verify models are discovered

openclaw models list

Wykryte modele pojawią się w ramach dostawcy amazon-bedrock-mantle. Nie jest wymagana dodatkowa konfiguracja, chyba że chcesz zastąpić wartości domyślne.

Najlepsze rozwiązanie dla: używania poświadczeń zgodnych z AWS SDK (wspólna konfiguracja, SSO, tożsamość internetowa, role instancji lub zadań).

Configure AWS credentials on the gateway host

Działa każde źródło uwierzytelniania zgodne z AWS SDK:

export AWS_PROFILE="default"
export AWS_REGION="us-west-2"

Verify models are discovered

openclaw models list

OpenClaw automatycznie generuje token okaziciela Mantle z łańcucha poświadczeń.

Gdy AWS_BEARER_TOKEN_BEDROCK nie jest ustawiony, OpenClaw tworzy token okaziciela na podstawie domyślnego łańcucha poświadczeń AWS, w tym współdzielonych poświadczeń i profili konfiguracji, SSO, tożsamości internetowej oraz ról instancji lub zadań.

Automatyczne wykrywanie modeli

Gdy ustawiony jest AWS_BEARER_TOKEN_BEDROCK, OpenClaw używa go bezpośrednio. W przeciwnym razie OpenClaw próbuje wygenerować token okaziciela Mantle na podstawie domyślnego łańcucha poświadczeń AWS. Następnie wykrywa dostępne modele Mantle, wysyłając zapytanie do regionalnego punktu końcowego /v1/models.

Zachowanie	Szczegóły
Pamięć podręczna wykrywania	Wyniki są buforowane przez 1 godzinę dla każdego regionu; niepowodzenie pobierania zwraca ostatni zapisany wynik
Odświeżanie tokenu IAM	Co 2 godziny, z buforowaniem dla każdego regionu

Aby pozostawić Plugin Mantle włączony, ale wyłączyć automatyczne wykrywanie i generowanie tokenu okaziciela IAM, wyłącz należący do Pluginu przełącznik wykrywania:

openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false

Jest to ten sam token okaziciela AWS_BEARER_TOKEN_BEDROCK, którego używa standardowy dostawca Amazon Bedrock.

Obsługiwane regiony

us-east-1, us-east-2, us-west-2, ap-northeast-1, ap-south-1, ap-southeast-3, eu-central-1, eu-west-1, eu-west-2, eu-south-1, eu-north-1, sa-east-1.

Konfiguracja ręczna

Jeśli zamiast automatycznego wykrywania wolisz jawną konfigurację:

{
  models: {
    providers: {
      "amazon-bedrock-mantle": {
        baseUrl: "https://bedrock-mantle.us-east-1.api.aws/v1",
        api: "openai-completions",
        auth: "api-key",
        apiKey: "env:AWS_BEARER_TOKEN_BEDROCK",
        models: [
          {
            id: "gpt-oss-120b",
            name: "GPT-OSS 120B",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 32000,
            maxTokens: 4096,
          },
        ],
      },
    },
  },
}

Jawna, niepusta lista models jest rozstrzygająca i zastępuje każdy wykryty wiersz, w tym poniższe wiersze Claude. Pomiń models, aby zachować automatyczny katalog Mantle, albo uwzględnij kompletne wpisy modeli Claude, których chcesz używać.

Konfiguracja zaawansowana

Reasoning support

Obsługa rozumowania jest ustalana na podstawie identyfikatorów modeli zawierających wzorce takie jak thinking, reasoner, reasoning, deepseek.r, gpt-oss-120b lub gpt-oss-safeguard-120b. Podczas wykrywania OpenClaw automatycznie ustawia reasoning: true dla pasujących modeli.

Endpoint unavailability

Jeśli punkt końcowy Mantle jest niedostępny, nie zwraca modeli albo nie uda się rozpoznać tokenu okaziciela, wykrywanie zwraca pusty wynik, a niejawny dostawca jest pomijany. OpenClaw nie zgłasza błędu; pozostali skonfigurowani dostawcy nadal działają normalnie.

Claude via the Anthropic Messages route

Gdy lista modeli jest zarządzana przez automatyczne wykrywanie, po pomyślnym wyszukaniu OpenClaw dodaje cztery modele Claude, niezależnie od tego, co zwraca /v1/models: amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5), amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7) oraz amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5), a także amazon-bedrock-mantle/anthropic.claude-mythos-preview (Claude Mythos Preview). Korzystają one z interfejsu API anthropic-messages i przesyłają strumieniowo dane przez ten sam uwierzytelniany tokenem okaziciela punkt końcowy zgodny z Anthropic (<mantle-base>/anthropic), dlatego token okaziciela AWS nie jest traktowany jak klucz API Anthropic.Claude Sonnet 5 zawsze korzysta z adaptacyjnego rozumowania i domyślnie używa poziomu nakładu high. /think off oraz /think minimal są mapowane na low, ponieważ trasa Mantle nie może wyłączyć rozumowania. OpenClaw pomija również niestandardową temperaturę w żądaniach Sonnet 5.Dostęp do Claude Mythos 5 jest ograniczony. Model udostępnia okno kontekstu obejmujące 1 000 000 tokenów oraz limit danych wyjściowych wynoszący 128 000 tokenów, zawsze korzysta z adaptacyjnego rozumowania, mapuje /think off oraz /think minimal na low i pomija parametry próbkowania wybrane przez wywołującego.Claude Mythos Preview zawsze żąda rozumowania, domyślnie używając poziomu nakładu high, gdy nie ustawiono poziomu /think (xhigh/max są mapowane w dół na high, a minimal w górę na low). Opus 4.7 w Mantle przesyła dane strumieniowo bez rozumowania dostarczanego przez model, a OpenClaw pomija jego parametr temperature, ponieważ Opus 4.7 nie akceptuje zastępowania ustawień próbkowania na tej trasie; Mythos Preview normalnie akceptuje zastąpienie wartości temperature.Niepusta jawna lista models.providers["amazon-bedrock-mantle"].models zastępuje cały wykryty katalog. Pomiń tę listę, jeśli chcesz korzystać z tych wbudowanych wierszy Claude.

Relationship to Amazon Bedrock provider

Bedrock Mantle jest dostawcą odrębnym od standardowego dostawcy Amazon Bedrock. Mantle używa interfejsu zgodnego z OpenAI /v1 dla swojego katalogu OSS, natomiast standardowy dostawca Bedrock używa natywnego API Bedrock Converse.Obaj dostawcy używają tego samego poświadczenia AWS_BEARER_TOKEN_BEDROCK, gdy jest ono dostępne.

Powiązane materiały

Amazon Bedrock

Natywny dostawca Bedrock dla Anthropic Claude, Titan i innych modeli.

Model selection

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

OAuth and auth

Szczegóły uwierzytelniania i zasady ponownego używania poświadczeń.

Troubleshooting

Typowe problemy i sposoby ich rozwiązywania.

Overview

Concepts and configuration

Providers

Amazon Bedrock Mantle

Pierwsze kroki

Automatyczne wykrywanie modeli

Obsługiwane regiony

Konfiguracja ręczna

Konfiguracja zaawansowana

Powiązane materiały

Amazon Bedrock

Model selection

OAuth and auth

Troubleshooting

​Pierwsze kroki

​Automatyczne wykrywanie modeli

​Obsługiwane regiony

​Konfiguracja ręczna

​Konfiguracja zaawansowana

​Powiązane materiały

Amazon Bedrock

Model selection

OAuth and auth

Troubleshooting

Pierwsze kroki

Automatyczne wykrywanie modeli

Obsługiwane regiony

Konfiguracja ręczna

Konfiguracja zaawansowana

Powiązane materiały