Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw include un provider Amazon Bedrock Mantle integrato che si connette all’endpoint compatibile con OpenAI di Mantle. 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)
AuthAWS_BEARER_TOKEN_BEDROCK esplicito o generazione del bearer token tramite catena di credenziali IAM
Regione predefinitaus-east-1 (sovrascrivi con AWS_REGION o AWS_DEFAULT_REGION)

Per iniziare

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

Imposta il bearer token 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"
2

Verifica che i modelli vengano rilevati

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. In caso contrario, OpenClaw prova a generare un bearer token Mantle dalla catena di credenziali predefinita di AWS. Poi rileva i modelli Mantle disponibili interrogando l’endpoint /v1/models della regione.
ComportamentoDettaglio
Cache di rilevamentoRisultati memorizzati 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 l’interruttore 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 inferito dagli ID dei modelli che contengono pattern come thinking, reasoner o gpt-oss-120b. OpenClaw imposta reasoning: true automaticamente 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) è chiamabile 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 coniato).
{
  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 Bedrock nativa.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.

Selezione del modello

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

OAuth e autenticazione

Dettagli di autenticazione e regole di riuso delle credenziali.

Risoluzione dei problemi

Problemi comuni e come risolverli.