Aller au contenu

Amazon Bedrock Mantle

OpenClaw inclut un provider Amazon Bedrock Mantle intégré qui se connecte au endpoint compatible Mantle OpenAI. Mantle héberge des modèles open-source et tiers (GPT-OSS, Qwen, Kimi, GLM, et similaires) via une surface /v1/chat/completions standard soutenue par l’infrastructure Bedrock.

PropriétéValeur
ID du fournisseuramazon-bedrock-mantle
APIopenai-completions (compatible OpenAI) ou anthropic-messages (route Messages Anthropic)
AuthAWS_BEARER_TOKEN_BEDROCK explicite ou génération de bearer-token via chaîne d’informations d’identification IAM
Région par défautus-east-1 (remplacer par AWS_REGION ou AWS_DEFAULT_REGION)

Choisissez votre méthode d’authentification préférée et suivez les étapes de configuration.

Idéal pour : les environnements où vous possédez déjà un jeton bearer Mantle.

  1. Définir le jeton bearer sur l'hôte de la passerelle

    Fenêtre de terminal
    export AWS_BEARER_TOKEN_BEDROCK="..."

    Définissez optionnellement une région (par défaut us-east-1) :

    Fenêtre de terminal
    export AWS_REGION="us-west-2"
  2. Vérifier que les modèles sont découverts

    Fenêtre de terminal
    openclaw models list

    Les modèles découverts apparaissent sous le provider amazon-bedrock-mantle. Aucune configuration supplémentaire n’est requise sauf si vous souhaitez remplacer les valeurs par défaut.

Lorsque AWS_BEARER_TOKEN_BEDROCK est défini, OpenClaw l’utilise directement. Sinon, OpenClaw tente de générer un jeton porteur Mantle à partir de la chaîne d’informations d’identification par défaut d’AWS. Il découvre ensuite les modèles Mantle disponibles en interrogeant le point de terminaison /v1/models de la région.

ComportementDétail
Cache de découverteRésultats mis en cache pendant 1 heure
Actualisation du jeton IAMToutes les heures

Pour garder le plugin Mantle activé mais supprimer la découverte automatique et la génération de jetons porteur IAM, désactivez l’interrupteur de découverte détenu par le plugin :

Fenêtre de terminal
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false

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.

Si vous préférez une configuration explicite plutôt que la découverte automatique :

{
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,
},
],
},
},
},
}
Prise en charge du raisonnement

La prise en charge du raisonnement est déduite des identifiants de modèle contenant des modèles comme thinking, reasoner, ou gpt-oss-120b. OpenClaw définit reasoning: true automatiquement pour les modèles correspondants lors de la découverte.

Indisponibilité du point de terminaison

Si le point de terminaison Mantle est indisponible ou ne renvoie aucun modèle, le fournisseur est ignoré silencieusement. OpenClaw ne génère pas d’erreur ; les autres fournisseurs configurés continuent de fonctionner normalement.

Claude Opus 4.7 via la route Messages Anthropic

Mantle expose également une route Messages Anthropic qui achemine les modèles Claude via le même chemin de flux authentifié par porteur. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) est appelable via cette route avec un flux propriétaire du fournisseur, les jetons porteurs AWS ne sont donc pas traités comme des clés Anthropic API.

Lorsque vous épinglez un modèle Messages Anthropic sur le fournisseur Mantle, OpenClaw utilise la surface API anthropic-messages au lieu de openai-completions pour ce modèle. L’authentification provient toujours de AWS_BEARER_TOKEN_BEDROCK (ou du jeton porteur IAM frappé).

{
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,
},
],
},
},
},
}
Relation avec le fournisseur Amazon Bedrock

Bedrock Mantle est un fournisseur distinct du fournisseur standard Amazon Bedrock. Mantle utilise une surface /v1 compatible OpenAI, tandis que le fournisseur Bedrock standard utilise l’API native Bedrock.

Les deux fournisseurs partagent les mêmes informations d’identification AWS_BEARER_TOKEN_BEDROCK lorsqu’elles sont présentes.

Amazon BedrockAmazon Bedrock

Fournisseur Bedrock natif pour les modèles Anthropic Claude, Titan et autres.

Sélection de modèle

Choisir les fournisseurs, les références de modèle et le comportement de basculement.

OAuthOAuth et auth

Détails d’authentification et règles de réutilisation des informations d’identification.

Dépannage

Problèmes courants et comment les résoudre.