Providers
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 firm trzecich (GPT-OSS, Qwen, Kimi, GLM i podobne) przez standardową
powierzchnię /v1/chat/completions opartą na infrastrukturze Bedrock.
| Właściwość | Wartość |
|---|---|
| ID dostawcy | amazon-bedrock-mantle |
| API | openai-completions (zgodne z OpenAI) lub anthropic-messages (trasa Anthropic Messages) |
| Uwierzytelnianie | Jawny AWS_BEARER_TOKEN_BEDROCK lub generowanie tokenu bearer z łańcucha poświadczeń IAM |
| Domyślny region | us-east-1 (nadpisz przez AWS_REGION lub AWS_DEFAULT_REGION) |
Pierwsze kroki
Wybierz preferowaną metodę uwierzytelniania i wykonaj kroki konfiguracji.
Jawny token bearer
Najlepsze dla: środowisk, w których masz już token bearer Mantle.
Ustaw token bearer na hoście Gateway
export AWS_BEARER_TOKEN_BEDROCK="..."Opcjonalnie ustaw region (domyślnie us-east-1):
export AWS_REGION="us-west-2"Włącz udostępnianie danych dostawcy dla Claude Fable 5
Claude Fable 5 i modele Bedrock klasy Claude Mythos wymagają trybu API przechowywania danych Mantle provider_data_share przed wywołaniem. To włączenie pozwala Bedrock udostępniać prompty i uzupełnienia Anthropic oraz przechowywać je do 30 dni na potrzeby przeglądu zaufania i bezpieczeństwa.
AWS_REGION="${AWS_REGION:-us-east-1}"curl -X PUT "https://bedrock-mantle.${AWS_REGION}.api.aws/v1/data_retention" \ -H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK" \ -H "Content-Type: application/json" \ -d '{ "mode": "provider_data_share" }'Użyj w konfiguracji innego modelu Bedrock, jeśli nie możesz zaakceptować tego trybu przechowywania.
Sprawdź, czy modele zostały wykryte
openclaw models listWykryte modele pojawiają się pod dostawcą amazon-bedrock-mantle. Nie jest
wymagana dodatkowa konfiguracja, chyba że chcesz nadpisać wartości domyślne.
Poświadczenia IAM
Najlepsze dla: używania poświadczeń zgodnych z AWS SDK (wspólna konfiguracja, SSO, tożsamość web, role instancji lub zadań).
Skonfiguruj poświadczenia AWS na hoście Gateway
Działa każde źródło uwierzytelniania zgodne z AWS SDK:
export AWS_PROFILE="default"export AWS_REGION="us-west-2"Sprawdź, czy modele zostały wykryte
openclaw models listOpenClaw automatycznie generuje token bearer Mantle z łańcucha poświadczeń.
Automatyczne wykrywanie modeli
Gdy AWS_BEARER_TOKEN_BEDROCK jest ustawiony, OpenClaw używa go bezpośrednio. W przeciwnym razie
OpenClaw próbuje wygenerować token bearer Mantle z 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ę |
| Odświeżanie tokenu IAM | Co godzinę |
Aby pozostawić Plugin Mantle włączony, ale wyłączyć automatyczne wykrywanie i generowanie tokenu bearer IAM, wyłącz przełącznik wykrywania należący do Plugin:
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled falseObsł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 wolisz jawną konfigurację zamiast automatycznego wykrywania:
{ 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, }, ], }, }, },}Konfiguracja zaawansowana
Obsługa rozumowania
Obsługa rozumowania jest wnioskowana z identyfikatorów modeli zawierających wzorce takie jak
thinking, reasoner lub gpt-oss-120b. OpenClaw ustawia reasoning: true
automatycznie dla pasujących modeli podczas wykrywania.
Niedostępność punktu końcowego
Jeśli punkt końcowy Mantle jest niedostępny lub nie zwraca żadnych modeli, dostawca jest pomijany po cichu. OpenClaw nie zgłasza błędu; inni skonfigurowani dostawcy nadal działają normalnie.
Claude Opus 4.7 przez trasę Anthropic Messages
Mantle udostępnia także trasę Anthropic Messages, która przenosi modele Claude przez tę samą ścieżkę strumieniowania uwierzytelnianą tokenem bearer. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) można wywoływać przez tę trasę ze strumieniowaniem należącym do dostawcy, więc tokeny bearer AWS nie są traktowane jak klucze API Anthropic.
Gdy przypniesz model Anthropic Messages u dostawcy Mantle, OpenClaw używa dla tego modelu powierzchni API anthropic-messages zamiast openai-completions. Uwierzytelnianie nadal pochodzi z AWS_BEARER_TOKEN_BEDROCK (lub utworzonego tokenu bearer IAM).
{ models: { providers: { "amazon-bedrock-mantle": { models: [ { id: "claude-opus-4.7", name: "Claude Opus 4.7", api: "anthropic-messages", reasoning: true, input: ["text", "image"], contextWindow: 1000000, maxTokens: 32000, }, ], }, }, },}Relacja z dostawcą Amazon Bedrock
Bedrock Mantle jest osobnym dostawcą względem standardowego
dostawcy Amazon Bedrock. Mantle używa
powierzchni /v1 zgodnej z OpenAI, natomiast standardowy dostawca Bedrock używa
natywnego API Bedrock.
Obaj dostawcy współdzielą te same poświadczenie AWS_BEARER_TOKEN_BEDROCK, gdy
jest dostępne.
Powiązane
Natywny dostawca Bedrock dla Anthropic Claude, Titan i innych modeli.
Wybieranie dostawców, odwołań do modeli i zachowania przełączania awaryjnego.
Szczegóły uwierzytelniania i reguły ponownego używania poświadczeń.
Typowe problemy i sposoby ich rozwiązywania.
