Vai al contenuto principale
OpenClaw include un provider Amazon Bedrock Mantle in bundle che si collega all’endpoint Mantle compatibile con OpenAI. Mantle ospita modelli open-source e di terze parti (GPT-OSS, Qwen, Kimi, GLM e simili) tramite una superficie /v1/chat/completions standard supportata dall’infrastruttura Bedrock.
ProprietàValore
ID provideramazon-bedrock-mantle
APIopenai-completions (compatibile con OpenAI) o anthropic-messages (route Anthropic Messages)
AutenticazioneAWS_BEARER_TOKEN_BEDROCK esplicito o generazione del bearer token tramite catena di credenziali IAM
Regione predefinitaus-east-1 (sovrascrivibile con AWS_REGION o AWS_DEFAULT_REGION)

Introduzione

Scegli il metodo di autenticazione preferito e segui i passaggi di configurazione.
Ideale per: ambienti in cui disponi già di un bearer token Mantle.
1

Set the bearer token on the gateway host

export AWS_BEARER_TOKEN_BEDROCK="..."
Facoltativamente, imposta una regione (predefinita: us-east-1):
export AWS_REGION="us-west-2"
2

Opt in to provider data sharing for Claude Fable 5

Claude Fable 5 e i modelli Bedrock di classe Claude Mythos richiedono la modalità provider_data_share dell’API Mantle Data Retention prima dell’invocazione. Questa adesione consente a Bedrock di condividere prompt e completamenti con Anthropic e di conservarli fino a 30 giorni per la revisione di fiducia e sicurezza.
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" }'
Usa un altro modello Bedrock nella configurazione se non puoi accettare quella modalità di conservazione.
3

Verify models are discovered

openclaw models list
I modelli rilevati compaiono sotto il provider amazon-bedrock-mantle. Non è richiesta alcuna configurazione aggiuntiva, a meno che tu non voglia sovrascrivere i valori predefiniti.

Rilevamento automatico dei modelli

Quando AWS_BEARER_TOKEN_BEDROCK è impostato, OpenClaw lo usa direttamente. Altrimenti, OpenClaw tenta di generare un bearer token Mantle dalla catena di credenziali predefinita di AWS. Quindi rileva i modelli Mantle disponibili interrogando l’endpoint /v1/models della regione.
ComportamentoDettaglio
Cache di rilevamentoRisultati memorizzati in cache per 1 ora
Aggiornamento token IAMOgni ora
Per mantenere abilitato il Plugin Mantle ma sopprimere il rilevamento automatico e la generazione del bearer token IAM, disabilita il toggle di rilevamento di proprietà del Plugin:
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false
Il bearer token è lo stesso AWS_BEARER_TOKEN_BEDROCK usato 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 invece del 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,
          },
        ],
      },
    },
  },
}

Configurazione avanzata

Il supporto al reasoning viene dedotto dagli ID dei modelli che contengono pattern come thinking, reasoner o gpt-oss-120b. OpenClaw imposta automaticamente reasoning: true per i modelli corrispondenti durante il rilevamento.
Se l’endpoint Mantle non è disponibile o non restituisce modelli, il provider viene ignorato silenziosamente. OpenClaw non genera errori; gli altri provider configurati continuano a funzionare normalmente.
Mantle espone anche una route Anthropic Messages che trasporta i modelli Claude attraverso lo stesso percorso di streaming autenticato con bearer token. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) è invocabile tramite questa route con streaming di proprietà del provider, quindi i bearer token AWS non vengono trattati come chiavi API Anthropic.Quando fissi un modello Anthropic Messages sul provider Mantle, OpenClaw usa la superficie API anthropic-messages invece di openai-completions per quel modello. L’autenticazione proviene comunque da AWS_BEARER_TOKEN_BEDROCK (o dal bearer token IAM creato).
{
  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,
          },
        ],
      },
    },
  },
}
Bedrock Mantle è un provider separato dal provider standard Amazon Bedrock. Mantle usa una superficie /v1 compatibile con OpenAI, mentre il provider Bedrock standard usa l’API nativa Bedrock.Entrambi i provider condividono la stessa credenziale AWS_BEARER_TOKEN_BEDROCK quando è presente.

Correlati

Amazon Bedrock

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

Model selection

Scelta dei provider, dei riferimenti modello e del comportamento di failover.

OAuth and auth

Dettagli di autenticazione e regole di riuso delle credenziali.

Troubleshooting

Problemi comuni e come risolverli.