Providers
Amazon Bedrock Mantle
OpenClaw enthält einen gebündelten Amazon Bedrock Mantle-Provider, der eine Verbindung zum OpenAI-kompatiblen Mantle-Endpunkt herstellt. Mantle hostet Open-Source- und Drittanbietermodelle (GPT-OSS, Qwen, Kimi, GLM und ähnliche) über eine standardmäßige /v1/chat/completions-Schnittstelle, die von Bedrock-Infrastruktur unterstützt wird.
| Eigenschaft | Wert |
|---|---|
| Provider-ID | amazon-bedrock-mantle |
| API | openai-completions (OpenAI-kompatibel) oder anthropic-messages (Anthropic-Messages-Route) |
| Auth | Explizites AWS_BEARER_TOKEN_BEDROCK oder IAM-Credential-Chain-Bearer-Token-Generierung |
| Standardregion | us-east-1 (mit AWS_REGION oder AWS_DEFAULT_REGION überschreiben) |
Erste Schritte
Wählen Sie Ihre bevorzugte Auth-Methode und folgen Sie den Einrichtungsschritten.
Explizites Bearer-Token
Am besten geeignet für: Umgebungen, in denen Sie bereits ein Mantle-Bearer-Token haben.
Bearer-Token auf dem Gateway-Host setzen
export AWS_BEARER_TOKEN_BEDROCK="..."Legen Sie optional eine Region fest (Standard ist us-east-1):
export AWS_REGION="us-west-2"Provider-Datenfreigabe für Claude Fable 5 aktivieren
Claude Fable 5 und Bedrock-Modelle der Claude-Mythos-Klasse erfordern vor dem Aufruf den Mantle-Data-Retention-API-Modus provider_data_share. Diese Aktivierung erlaubt Bedrock, Prompts und Completions mit Anthropic zu teilen und sie bis zu 30 Tage für Trust-and-Safety-Prüfungen aufzubewahren.
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" }'Verwenden Sie in der Konfiguration ein anderes Bedrock-Modell, wenn Sie diesen Aufbewahrungsmodus nicht akzeptieren können.
Überprüfen, ob Modelle erkannt werden
openclaw models listErkannte Modelle erscheinen unter dem Provider amazon-bedrock-mantle. Es ist keine zusätzliche Konfiguration erforderlich, sofern Sie die Standards nicht überschreiben möchten.
IAM-Anmeldedaten
Am besten geeignet für: die Verwendung AWS-SDK-kompatibler Anmeldedaten (gemeinsame Konfiguration, SSO, Webidentität, Instance- oder Task-Rollen).
AWS-Anmeldedaten auf dem Gateway-Host konfigurieren
Jede AWS-SDK-kompatible Auth-Quelle funktioniert:
export AWS_PROFILE="default"export AWS_REGION="us-west-2"Überprüfen, ob Modelle erkannt werden
openclaw models listOpenClaw generiert automatisch ein Mantle-Bearer-Token aus der Credential Chain.
Automatische Modellerkennung
Wenn AWS_BEARER_TOKEN_BEDROCK gesetzt ist, verwendet OpenClaw es direkt. Andernfalls versucht OpenClaw, ein Mantle-Bearer-Token aus der Standard-Credential-Chain von AWS zu generieren. Anschließend erkennt es verfügbare Mantle-Modelle, indem es den regionalen /v1/models-Endpunkt abfragt.
| Verhalten | Detail |
|---|---|
| Discovery-Cache | Ergebnisse werden 1 Stunde gecacht |
| IAM-Token-Aktualisierung | Stündlich |
Um das Mantle-Plugin aktiviert zu lassen, aber automatische Erkennung und IAM-Bearer-Token-Generierung zu unterdrücken, deaktivieren Sie den Plugin-eigenen Discovery-Schalter:
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 eine explizite Konfiguration statt automatischer Erkennung 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, }, ], }, }, },}Erweiterte Konfiguration
Reasoning-Unterstützung
Reasoning-Unterstützung wird aus Modell-IDs abgeleitet, die Muster wie thinking, reasoner oder gpt-oss-120b enthalten. OpenClaw setzt während der Erkennung automatisch reasoning: true für passende Modelle.
Endpunkt-Nichtverfügbarkeit
Wenn der Mantle-Endpunkt nicht verfügbar ist oder keine Modelle zurückgibt, wird der Provider stillschweigend übersprungen. OpenClaw gibt keinen Fehler aus; andere konfigurierte Provider funktionieren weiterhin normal.
Claude Opus 4.7 über die Anthropic-Messages-Route
Mantle stellt außerdem eine Anthropic-Messages-Route bereit, die Claude-Modelle über denselben Bearer-authentifizierten Streaming-Pfad führt. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) kann über diese Route mit Provider-eigenem Streaming aufgerufen werden, sodass AWS-Bearer-Token nicht wie Anthropic-API-Schlüssel behandelt werden.
Wenn Sie ein Anthropic-Messages-Modell auf dem Mantle-Provider festpinnen, verwendet OpenClaw für dieses Modell die API-Schnittstelle anthropic-messages statt openai-completions. Auth stammt weiterhin aus AWS_BEARER_TOKEN_BEDROCK (oder dem ausgestellten IAM-Bearer-Token).
{ 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, }, ], }, }, },}Beziehung zum Amazon-Bedrock-Provider
Bedrock Mantle ist ein separater Provider gegenüber dem standardmäßigen Amazon Bedrock-Provider. Mantle verwendet eine OpenAI-kompatible /v1-Schnittstelle, während der standardmäßige Bedrock-Provider die native Bedrock-API verwendet.
Beide Provider teilen sich dieselben AWS_BEARER_TOKEN_BEDROCK-Anmeldedaten, wenn sie vorhanden sind.
