Amazon Bedrock Mantle
OpenClaw incluye un proveedor Amazon Bedrock Mantle que se conecta al
punto de conexión compatible con OpenAI de Mantle. Mantle aloja modelos de
código abierto y de terceros (GPT-OSS, Qwen, Kimi, GLM y similares) a través de
una superficie /v1/chat/completions estándar respaldada por la infraestructura
de Bedrock.
| Propiedad | Valor |
|---|---|
| ID del proveedor | amazon-bedrock-mantle |
| API | openai-completions (compatible con OpenAI) o anthropic-messages (ruta de mensajes de Anthropic) |
| Autenticación | AWS_BEARER_TOKEN_BEDROCK explícito o generación de tokens de portador de la cadena de credenciales de IAM |
| Región predeterminada | us-east-1 (anular con AWS_REGION o AWS_DEFAULT_REGION) |
Primeros pasos
Sección titulada «Primeros pasos»Elija su método de autenticación preferido y siga los pasos de configuración.
Mejor para: entornos donde ya tienes un token de portador de Mantle.
Establecer el token de portador en el host de puerta de enlace
Ventana de terminal export AWS_BEARER_TOKEN_BEDROCK="..."Opcionalmente, establece una región (por defecto es
us-east-1):Ventana de terminal export AWS_REGION="us-west-2"Verificar que los modelos se descubren
Ventana de terminal openclaw models listLos modelos descubiertos aparecen bajo el proveedor
amazon-bedrock-mantle. No se requiere configuración adicional a menos que desees anular los valores predeterminados.
Mejor para: usar credenciales compatibles con el SDK de AWS (configuración compartida, SSO, identidad web, roles de instancia o tarea).
Configurar las credenciales de AWS en el host de la puerta de enlace
Funciona cualquier fuente de autenticación compatible con el SDK de AWS:
Ventana de terminal export AWS_PROFILE="default"export AWS_REGION="us-west-2"Verificar que los modelos se descubren
Ventana de terminal openclaw models listOpenClaw genera un token de portador de Mantle automáticamente a partir de la cadena de credenciales.
Descubrimiento automático de modelos
Sección titulada «Descubrimiento automático de modelos»Cuando AWS_BEARER_TOKEN_BEDROCK está configurado, OpenClaw lo usa directamente. De lo contrario,
OpenClaw intenta generar un token de portador de Mantle a partir de la cadena de
credenciales predeterminada de AWS. Luego descubre los modelos de Mantle disponibles consultando
el punto final /v1/models de la región.
| Comportamiento | Detalle |
|---|---|
| Caché de descubrimiento | Resultados almacenados en caché durante 1 hora |
| Actualización del token de IAM | Cada hora |
Para mantener el complemento Mantle habilitado pero suprimir el descubrimiento automático y la generación de tokens de portador de IAM, desactive el interruptor de descubrimiento propiedad del complemento:
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled falseRegiones compatibles
Sección titulada «Regiones compatibles»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.
Configuración manual
Sección titulada «Configuración manual»Si prefiere una configuración explícita en lugar del descubrimiento automático:
{ 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, }, ], }, }, },}Configuración avanzada
Sección titulada «Configuración avanzada»Soporte de razonamiento
El soporte de razonamiento se infiere de los IDs de modelo que contienen patrones como
thinking, reasoner o gpt-oss-120b. OpenClaw establece reasoning: true
automáticamente para los modelos coincidentes durante el descubrimiento.
Indisponibilidad del punto de conexión
Si el punto de conexión de Mantle no está disponible o no devuelve modelos, el proveedor se omite silenciosamente. OpenClaw no genera errores; otros proveedores configurados continúan funcionando con normalidad.
Claude Opus 4.7 a través de la ruta Anthropic Messages
Mantle también expone una ruta de Anthropic Messages que transporta los modelos Claude a través de la misma ruta de transmisión autenticada con portador. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) se puede invocar a través de esta ruta con transmisión propiedad del proveedor, por lo que los tokens de portador de AWS no se tratan como claves de API de Anthropic.
Cuando fijas un modelo de Anthropic Messages en el proveedor Mantle, OpenClaw utiliza la superficie de la API anthropic-messages en lugar de openai-completions para ese modelo. La autenticación aún proviene de AWS_BEARER_TOKEN_BEDROCK (o del token de portador IAM acuñado).
{ 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, }, ], }, }, },}Relación con el proveedor Amazon Bedrock
Bedrock Mantle es un proveedor separado del proveedor estándar
Amazon Bedrock. Mantle utiliza una
superficie /v1 compatible con OpenAI, mientras que el proveedor Bedrock estándar utiliza
la API nativa de Bedrock.
Ambos proveedores comparten la misma credencial AWS_BEARER_TOKEN_BEDROCK cuando
está presente.
Relacionado
Sección titulada «Relacionado»Proveedor nativo de Bedrock para Anthropic Claude, Titan y otros modelos.
Elección de proveedores, referencias de modelos y comportamiento de conmutación por error.
Detalles de autenticación y reglas de reutilización de credenciales.
Problemas comunes y cómo resolverlos.