Amazon Bedrock Mantle

OpenClaw include un provider Amazon Bedrock Mantle integrato che si connette all’endpoint di Mantle compatibile con OpenAI. Mantle ospita modelli open source e di terze parti (GPT-OSS, Qwen, Kimi, GLM e simili) tramite un’interfaccia standard /v1/chat/completions basata sull’infrastruttura Bedrock. Mantle espone inoltre i modelli Anthropic Claude tramite una route Anthropic Messages.

Proprietà	Valore
ID provider	`amazon-bedrock-mantle`
API	`openai-completions` per i modelli OSS rilevati, `anthropic-messages` per i modelli Claude
Autenticazione	`AWS_BEARER_TOKEN_BEDROCK` esplicito o generazione di un token bearer tramite la catena di credenziali IAM
Regione predefinita	`us-east-1` (sostituibile con `AWS_REGION` o `AWS_DEFAULT_REGION`)

Introduzione

Scegli il metodo di autenticazione preferito e segui i passaggi di configurazione.

Token bearer esplicito
Credenziali IAM

Ideale per: ambienti in cui disponi già di un token bearer Mantle.

Imposta il token bearer sull'host del Gateway

export AWS_BEARER_TOKEN_BEDROCK="..."

Facoltativamente, imposta una regione (il valore predefinito è us-east-1):

export AWS_REGION="us-west-2"

Verifica che i modelli vengano rilevati

openclaw models list

I modelli rilevati vengono visualizzati sotto il provider amazon-bedrock-mantle. Non è necessaria alcuna configurazione aggiuntiva, a meno che tu non voglia sostituire i valori predefiniti.

Ideale per: l’utilizzo di credenziali compatibili con AWS SDK (configurazione condivisa, SSO, identità Web, ruoli di istanza o attività).

Configura le credenziali AWS sull'host del Gateway

È supportata qualsiasi origine di autenticazione compatibile con AWS SDK:

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

Verifica che i modelli vengano rilevati

openclaw models list

OpenClaw genera automaticamente un token bearer Mantle dalla catena di credenziali.

Quando AWS_BEARER_TOKEN_BEDROCK non è impostato, OpenClaw genera per te il token bearer dalla catena di credenziali predefinita di AWS, incluse credenziali condivise, profili di configurazione, SSO, identità Web e ruoli di istanza o attività.

Rilevamento automatico dei modelli

Quando AWS_BEARER_TOKEN_BEDROCK è impostato, OpenClaw lo utilizza direttamente. In caso contrario, OpenClaw tenta di generare un token bearer Mantle dalla catena di credenziali predefinita di AWS. Successivamente rileva i modelli Mantle disponibili interrogando l’endpoint /v1/models della regione.

Comportamento	Dettagli
Cache del rilevamento	I risultati vengono memorizzati nella cache per 1 ora per regione; in caso di errore di recupero viene restituito l’ultimo risultato memorizzato
Aggiornamento del token IAM	Ogni 2 ore, con memorizzazione nella cache per regione

Per mantenere abilitato il plugin Mantle ma disattivare il rilevamento automatico e la generazione del token bearer IAM, disabilita l’opzione di rilevamento gestita dal plugin:

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

Il token bearer è lo stesso AWS_BEARER_TOKEN_BEDROCK utilizzato dal provider standard Amazon Bedrock.

Regioni supportate

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.

Configurazione manuale

Se preferisci una configurazione esplicita al rilevamento automatico:

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

Un elenco models esplicito e non vuoto è determinante e sostituisce ogni voce rilevata, incluse le voci Claude riportate di seguito. Ometti models per mantenere il catalogo Mantle automatico oppure includi tutte le voci dei modelli Claude che desideri utilizzare.

Configurazione avanzata

Supporto al ragionamento

Il supporto al ragionamento viene dedotto dagli ID dei modelli che contengono schemi come thinking, reasoner, reasoning, deepseek.r, gpt-oss-120b o gpt-oss-safeguard-120b. Durante il rilevamento, OpenClaw imposta automaticamente reasoning: true per i modelli corrispondenti.

Endpoint non disponibile

Se l’endpoint Mantle non è disponibile, non restituisce modelli o la risoluzione del token bearer non riesce, il rilevamento restituisce un risultato vuoto e il provider implicito viene ignorato. OpenClaw non restituisce un errore; gli altri provider configurati continuano a funzionare normalmente.

Claude tramite la route Anthropic Messages

Quando il rilevamento automatico gestisce l’elenco dei modelli, OpenClaw aggiunge quattro modelli Claude dopo una ricerca riuscita, indipendentemente da ciò che restituisce /v1/models: amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5), amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7) e amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5), oltre a amazon-bedrock-mantle/anthropic.claude-mythos-preview (anteprima di Claude Mythos). Utilizzano l’interfaccia API anthropic-messages e trasmettono il flusso tramite lo stesso endpoint compatibile con Anthropic e autenticato mediante bearer (<mantle-base>/anthropic), pertanto il token bearer AWS non viene trattato come una chiave API Anthropic.Claude Sonnet 5 utilizza sempre il pensiero adattivo e il livello di impegno predefinito è high. /think off e /think minimal vengono associati a low perché la route Mantle non può disabilitare il pensiero. OpenClaw omette inoltre la temperatura personalizzata per le richieste Sonnet 5.Claude Mythos 5 è ad accesso limitato. Offre una finestra di contesto di 1.000.000 di token e un limite di output di 128.000 token, utilizza sempre il pensiero adattivo, associa /think off e /think minimal a low e omette i parametri di campionamento selezionati dal chiamante.Claude Mythos Preview richiede sempre il ragionamento, con un livello di impegno predefinito pari a high quando non è impostato alcun livello /think (xhigh/max vengono ridotti a high e minimal viene aumentato a low). Opus 4.7 su Mantle trasmette il flusso senza ragionamento fornito dal modello e OpenClaw ne omette il parametro temperature, poiché Opus 4.7 non accetta sostituzioni dei parametri di campionamento su questa route; Mythos Preview accetta normalmente una sostituzione di temperature.Un elenco esplicito e non vuoto models.providers["amazon-bedrock-mantle"].models sostituisce l’intero catalogo rilevato. Ometti tale elenco se desideri queste voci Claude integrate.

Relazione con il provider Amazon Bedrock

Bedrock Mantle è un provider distinto dal provider standard Amazon Bedrock. Mantle utilizza un’interfaccia /v1 compatibile con OpenAI per il proprio catalogo OSS, mentre il provider Bedrock standard utilizza l’API nativa Bedrock Converse.Entrambi i provider condividono la stessa credenziale AWS_BEARER_TOKEN_BEDROCK, quando presente.

Contenuti correlati

Amazon Bedrock

Provider Bedrock nativo per Anthropic Claude, Titan e altri modelli.

Selezione del modello

Scelta dei provider, dei riferimenti ai modelli e del comportamento di failover.

OAuth e autenticazione

Dettagli sull’autenticazione e regole per il riutilizzo delle credenziali.

Risoluzione dei problemi

Problemi comuni e relative soluzioni.

Overview

Concepts and configuration

Providers

Amazon Bedrock Mantle

Introduzione

Rilevamento automatico dei modelli

Regioni supportate

Configurazione manuale

Configurazione avanzata

Contenuti correlati

Amazon Bedrock

Selezione del modello

OAuth e autenticazione

Risoluzione dei problemi

​Introduzione

​Rilevamento automatico dei modelli

​Regioni supportate

​Configurazione manuale

​Configurazione avanzata

​Contenuti correlati

Amazon Bedrock

Selezione del modello

OAuth e autenticazione

Risoluzione dei problemi

Introduzione

Rilevamento automatico dei modelli

Regioni supportate

Configurazione manuale

Configurazione avanzata

Contenuti correlati