Providers
Amazon Bedrock Mantle
OpenClaw enthält einen gebündelten Amazon Bedrock Mantle-Provider, der eine Verbindung zum OpenAI-kompatiblen Mantle-Endpunkt herstellt. Mantle stellt Open-Source- und Drittanbietermodelle (GPT-OSS, Qwen, Kimi, GLM und ähnliche) über eine standardmäßige, auf der Bedrock-Infrastruktur basierende /v1/chat/completions-Schnittstelle bereit. Mantle stellt außerdem Anthropic-Claude-Modelle über eine Anthropic-Messages-Route bereit.
| Eigenschaft | Wert |
|---|---|
| Provider-ID | amazon-bedrock-mantle |
| API | openai-completions für erkannte OSS-Modelle, anthropic-messages für Claude-Modelle |
| Authentifizierung | Explizites AWS_BEARER_TOKEN_BEDROCK oder Generierung eines Bearer-Tokens über die IAM-Anmeldedatenkette |
| Standardregion | us-east-1 (mit AWS_REGION oder AWS_DEFAULT_REGION überschreiben) |
Erste Schritte
Wählen Sie Ihre bevorzugte Authentifizierungsmethode und führen Sie die Einrichtungsschritte aus.
Explizites Bearer-Token
Am besten geeignet für: Umgebungen, in denen bereits ein Mantle-Bearer-Token vorhanden ist.
Bearer-Token auf dem Gateway-Host festlegen
export AWS_BEARER_TOKEN_BEDROCK="..."Legen Sie optional eine Region fest (Standard: us-east-1):
export AWS_REGION="us-west-2"Erkennung der Modelle überprüfen
openclaw models listErkannte Modelle werden unter dem Provider amazon-bedrock-mantle angezeigt. Sofern Sie die Standardwerte nicht überschreiben möchten, ist keine zusätzliche Konfiguration erforderlich.
IAM-Anmeldedaten
Am besten geeignet für: die Verwendung AWS-SDK-kompatibler Anmeldedaten (gemeinsame Konfiguration, SSO, Webidentität, Instanz- oder Aufgabenrollen).
AWS-Anmeldedaten auf dem Gateway-Host konfigurieren
Jede AWS-SDK-kompatible Authentifizierungsquelle wird unterstützt:
export AWS_PROFILE="default"export AWS_REGION="us-west-2"Erkennung der Modelle überprüfen
openclaw models listOpenClaw generiert automatisch ein Mantle-Bearer-Token aus der Anmeldedatenkette.
Automatische Modellerkennung
Wenn AWS_BEARER_TOKEN_BEDROCK festgelegt ist, verwendet OpenClaw es direkt. Andernfalls versucht OpenClaw, ein Mantle-Bearer-Token aus der standardmäßigen AWS-Anmeldedatenkette zu generieren. Anschließend erkennt OpenClaw verfügbare Mantle-Modelle durch Abfrage des regionalen /v1/models-Endpunkts.
| Verhalten | Details |
|---|---|
| Erkennungs-Cache | Ergebnisse werden pro Region 1 Stunde zwischengespeichert; bei einem Abruffehler wird das letzte Cache-Ergebnis zurückgegeben |
| IAM-Token-Aktualisierung | Alle 2 Stunden, pro Region zwischengespeichert |
Um das Mantle-Plugin aktiviert zu lassen, aber die automatische Erkennung und die Generierung von IAM-Bearer-Tokens zu unterdrücken, deaktivieren Sie den Plugin-eigenen Schalter für die Erkennung:
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled falseUnterstützte Regionen
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.
Manuelle Konfiguration
Wenn Sie statt der automatischen Erkennung eine explizite Konfiguration bevorzugen:
{ 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, }, ], }, }, },}Eine explizite, nicht leere models-Liste ist maßgeblich und ersetzt jede erkannte Zeile, einschließlich der nachfolgenden Claude-Zeilen. Lassen Sie models weg, um den automatischen Mantle-Katalog beizubehalten, oder fügen Sie die vollständigen Einträge der Claude-Modelle ein, die Sie verwenden möchten.
Erweiterte Konfiguration
Unterstützung für logisches Schlussfolgern
Die Unterstützung für logisches Schlussfolgern wird anhand von Modell-IDs abgeleitet, die Muster wie thinking, reasoner, reasoning, deepseek.r, gpt-oss-120b oder gpt-oss-safeguard-120b enthalten. OpenClaw setzt bei der Erkennung für passende Modelle automatisch reasoning: true.
Nichtverfügbarkeit des Endpunkts
Wenn der Mantle-Endpunkt nicht verfügbar ist, keine Modelle zurückgibt oder die Auflösung des Bearer-Tokens fehlschlägt, liefert die Erkennung ein leeres Ergebnis zurück und der implizite Provider wird übersprungen. OpenClaw gibt keinen Fehler aus; andere konfigurierte Provider funktionieren weiterhin wie gewohnt.
Claude über die Anthropic-Messages-Route
Wenn die Modellliste von der automatischen Erkennung verwaltet wird, fügt OpenClaw nach einer erfolgreichen Abfrage unabhängig von der Rückgabe von /v1/models vier Claude-Modelle hinzu:
amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5),
amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7) und
amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5) sowie
amazon-bedrock-mantle/anthropic.claude-mythos-preview (Claude Mythos
Preview). Sie verwenden die API-Schnittstelle anthropic-messages und streamen über denselben mit einem Bearer-Token authentifizierten Anthropic-kompatiblen Endpunkt (<mantle-base>/anthropic), sodass das AWS-Bearer-Token nicht wie ein Anthropic-API-Schlüssel behandelt wird.
Claude Sonnet 5 verwendet immer adaptives Denken und standardmäßig den Aufwand high. /think off und /think minimal werden low zugeordnet, da die Mantle-Route das Denken nicht deaktivieren kann. OpenClaw lässt bei Anfragen an Sonnet 5 außerdem eine benutzerdefinierte Temperatur aus.
Der Zugriff auf Claude Mythos 5 ist eingeschränkt. Das Modell bietet ein Kontextfenster von 1.000.000 Tokens und ein Ausgabelimit von 128.000 Tokens, verwendet immer adaptives Denken, ordnet /think off und /think minimal dem Wert low zu und lässt vom Aufrufer ausgewählte Stichprobenparameter aus.
Claude Mythos Preview fordert immer logisches Schlussfolgern an und verwendet standardmäßig den Aufwand high, wenn keine /think-Stufe festgelegt ist (xhigh/max werden auf high herabgestuft und minimal auf low angehoben). Opus 4.7 streamt über Mantle ohne vom Modell bereitgestellte Schlussfolgerungen. OpenClaw lässt außerdem den Parameter temperature aus, da Opus 4.7 auf dieser Route keine Überschreibungen der Stichprobenparameter akzeptiert; Mythos Preview akzeptiert eine Überschreibung von temperature wie gewohnt.
Eine nicht leere explizite Liste models.providers["amazon-bedrock-mantle"].models ersetzt den vollständigen erkannten Katalog. Lassen Sie diese Liste weg, wenn Sie diese integrierten Claude-Zeilen verwenden möchten.
Beziehung zum Amazon-Bedrock-Provider
Bedrock Mantle ist ein vom standardmäßigen Amazon-Bedrock-Provider getrennter Provider. Mantle verwendet für seinen OSS-Katalog eine OpenAI-kompatible /v1-Schnittstelle, während der standardmäßige Bedrock-Provider die native Bedrock-Converse-API verwendet.
Beide Provider verwenden dieselben AWS_BEARER_TOKEN_BEDROCK-Anmeldedaten, sofern diese vorhanden sind.
Verwandte Themen
Nativer Bedrock-Provider für Anthropic Claude, Titan und weitere Modelle.
Auswahl von Providern, Modellreferenzen und Failover-Verhalten.
Details zur Authentifizierung und Regeln für die Wiederverwendung von Anmeldedaten.
Häufige Probleme und deren Behebung.
