OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Amazon Bedrock Mantle

OpenClaw bevat een meegeleverde Amazon Bedrock Mantle-provider die verbinding maakt met het OpenAI-compatibele Mantle-eindpunt. Mantle host opensource- en modellen van derden (GPT-OSS, Qwen, Kimi, GLM en vergelijkbare modellen) via een standaard /v1/chat/completions-interface die wordt ondersteund door de Bedrock-infrastructuur. Mantle stelt ook Anthropic Claude-modellen beschikbaar via een Anthropic Messages-route.

Eigenschap Waarde
Provider-ID amazon-bedrock-mantle
API openai-completions voor gedetecteerde OSS-modellen, anthropic-messages voor Claude-modellen
Authenticatie Expliciete AWS_BEARER_TOKEN_BEDROCK of het genereren van een bearertoken via de IAM-referentieketen
Standaardregio us-east-1 (overschrijven met AWS_REGION of AWS_DEFAULT_REGION)

Aan de slag

Kies de gewenste authenticatiemethode en volg de configuratiestappen.

Expliciet bearertoken

Het meest geschikt voor: omgevingen waarin u al een Mantle-bearertoken hebt.

  • Stel het bearertoken in op de Gateway-host

    bash
    export AWS_BEARER_TOKEN_BEDROCK="..."

    Stel desgewenst een regio in (standaard us-east-1):

    bash
    export AWS_REGION="us-west-2"

  • Controleer of modellen worden gedetecteerd

    bash
    openclaw models list

    Gedetecteerde modellen worden weergegeven onder de provider amazon-bedrock-mantle. Er is geen aanvullende configuratie vereist, tenzij u de standaardwaarden wilt overschrijven.

    • IAM-referenties

    Het meest geschikt voor: het gebruik van AWS SDK-compatibele referenties (gedeelde configuratie, SSO, webidentiteit, instantie- of taakrollen).

  • Configureer AWS-referenties op de Gateway-host

    Elke AWS SDK-compatibele authenticatiebron werkt:

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

  • Controleer of modellen worden gedetecteerd

    bash
    openclaw models list

    OpenClaw genereert automatisch een Mantle-bearertoken uit de referentieketen.

    • Automatische modeldetectie

    Wanneer AWS_BEARER_TOKEN_BEDROCK is ingesteld, gebruikt OpenClaw dit rechtstreeks. Anders probeert OpenClaw een Mantle-bearertoken te genereren vanuit de standaardreferentieketen van AWS. Vervolgens detecteert het beschikbare Mantle-modellen door het /v1/models-eindpunt van de regio op te vragen.

    Gedrag Details
    Detectiecache Resultaten worden per regio 1 uur gecachet; bij een ophaalfout wordt het laatst gecachete resultaat geretourneerd
    Vernieuwing van IAM-token Elke 2 uur, per regio gecachet

    Als u de Mantle-Plugin ingeschakeld wilt houden maar automatische detectie en het genereren van IAM-bearertokens wilt onderdrukken, schakelt u de detectieschakelaar van de Plugin uit:

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

    Ondersteunde regio's

    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.

    Handmatige configuratie

    Als u expliciete configuratie verkiest boven automatische detectie:

    json5
    {  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,          },        ],      },    },  },}

    Een expliciete, niet-lege models-lijst is bepalend en vervangt elke gedetecteerde rij, inclusief de Claude-rijen hieronder. Laat models weg om de automatische Mantle-catalogus te behouden, of neem de volledige Claude-modelvermeldingen op die u wilt gebruiken.

    Geavanceerde configuratie

    Ondersteuning voor redeneren

    Ondersteuning voor redeneren wordt afgeleid uit model-ID's die patronen bevatten zoals thinking, reasoner, reasoning, deepseek.r, gpt-oss-120b of gpt-oss-safeguard-120b. OpenClaw stelt tijdens de detectie automatisch reasoning: true in voor overeenkomende modellen.

    Onbeschikbaarheid van het eindpunt

    Als het Mantle-eindpunt niet beschikbaar is, geen modellen retourneert of het bepalen van het bearertoken mislukt, retourneert de detectie een leeg resultaat en wordt de impliciete provider overgeslagen. OpenClaw geeft geen foutmelding; andere geconfigureerde providers blijven normaal functioneren.

    Claude via de Anthropic Messages-route

    Wanneer automatische detectie de modellenlijst beheert, voegt OpenClaw na een geslaagde zoekactie vier Claude-modellen toe, ongeacht wat /v1/models retourneert: amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5), amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7) en amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5), plus amazon-bedrock-mantle/anthropic.claude-mythos-preview (Claude Mythos Preview). Ze gebruiken de anthropic-messages-API-interface en streamen via hetzelfde met een bearertoken geauthenticeerde, Anthropic-compatibele eindpunt (<mantle-base>/anthropic), zodat het AWS-bearertoken niet als een Anthropic-API-sleutel wordt behandeld.

    Claude Sonnet 5 gebruikt altijd adaptief denken en hanteert standaard een high inspanningsniveau. /think off en /think minimal worden toegewezen aan low, omdat de Mantle-route denken niet kan uitschakelen. OpenClaw laat ook een aangepaste temperatuur weg voor Sonnet 5-aanvragen.

    Claude Mythos 5 heeft beperkte toegang. Het biedt een contextvenster van 1.000.000 tokens en een uitvoerlimiet van 128.000 tokens, gebruikt altijd adaptief denken, wijst /think off en /think minimal toe aan low en laat door de aanroeper geselecteerde bemonsteringsparameters weg.

    Claude Mythos Preview vraagt altijd om redeneren en gebruikt standaard een high inspanningsniveau wanneer geen /think-niveau is ingesteld (xhigh/max wordt verlaagd naar high en minimal verhoogd naar low). Opus 4.7 op Mantle streamt zonder door het model aangeleverde redenering en OpenClaw laat de parameter temperature weg, omdat Opus 4.7 op deze route geen overschrijvingen voor bemonstering accepteert; Mythos Preview accepteert normaal een overschrijving voor temperature.

    Een niet-lege expliciete lijst models.providers["amazon-bedrock-mantle"].models vervangt de volledige gedetecteerde catalogus. Laat die lijst weg wanneer u deze ingebouwde Claude-rijen wilt gebruiken.

    Relatie met de Amazon Bedrock-provider

    Bedrock Mantle is een afzonderlijke provider ten opzichte van de standaardprovider Amazon Bedrock. Mantle gebruikt een OpenAI-compatibele /v1-interface voor zijn OSS-catalogus, terwijl de standaard Bedrock-provider de systeemeigen Bedrock Converse-API gebruikt.

    Beide providers delen dezelfde AWS_BEARER_TOKEN_BEDROCK-referentie wanneer deze aanwezig is.

    Gerelateerd

    Amazon Bedrock

    Systeemeigen Bedrock-provider voor Anthropic Claude, Titan en andere modellen.
    Modelselectie

    Providers, modelverwijzingen en failovergedrag kiezen.
    OAuth en authenticatie

    Details over authenticatie en regels voor hergebruik van referenties.
    Probleemoplossing

    Veelvoorkomende problemen en hoe u ze oplost.
    Was this useful?
    On this page

    On this page