Providers
Amazon Bedrock Mantle
OpenClaw incluye un proveedor Amazon Bedrock Mantle integrado que se conecta al
endpoint compatible con OpenAI de Mantle. Mantle aloja modelos de código abierto y
de terceros (GPT-OSS, Qwen, Kimi, GLM y similares) mediante una superficie estándar
/v1/chat/completions 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 Anthropic Messages) |
| Autenticación | AWS_BEARER_TOKEN_BEDROCK explícito o generación de bearer token mediante la cadena de credenciales de IAM |
| Región predeterminada | us-east-1 (sobrescribir con AWS_REGION o AWS_DEFAULT_REGION) |
Primeros pasos
Elige tu método de autenticación preferido y sigue los pasos de configuración.
Explicit bearer token
Ideal para: entornos donde ya tienes un bearer token de Mantle.
Set the bearer token on the gateway host
export AWS_BEARER_TOKEN_BEDROCK="..."Opcionalmente, define una región (el valor predeterminado es us-east-1):
export AWS_REGION="us-west-2"Opt in to provider data sharing for Claude Fable 5
Claude Fable 5 y los modelos Bedrock de clase Claude Mythos requieren el modo provider_data_share de la API Mantle Data Retention antes de la invocación. Esta adhesión permite que Bedrock comparta prompts y completions con Anthropic y los conserve hasta 30 días para revisión de confianza y seguridad.
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 otro modelo de Bedrock en la configuración si no puedes aceptar ese modo de retención.
Verify models are discovered
openclaw models listLos modelos descubiertos aparecen bajo el proveedor amazon-bedrock-mantle. No se requiere
configuración adicional salvo que quieras sobrescribir los valores predeterminados.
IAM credentials
Ideal para: usar credenciales compatibles con AWS SDK (configuración compartida, SSO, identidad web, roles de instancia o de tarea).
Configure AWS credentials on the gateway host
Cualquier fuente de autenticación compatible con AWS SDK funciona:
export AWS_PROFILE="default"export AWS_REGION="us-west-2"Verify models are discovered
openclaw models listOpenClaw genera automáticamente un bearer token de Mantle a partir de la cadena de credenciales.
Descubrimiento automático de modelos
Cuando AWS_BEARER_TOKEN_BEDROCK está definido, OpenClaw lo usa directamente. En caso contrario,
OpenClaw intenta generar un bearer token de Mantle a partir de la cadena de
credenciales predeterminada de AWS. Luego descubre los modelos de Mantle disponibles consultando el
endpoint /v1/models de la región.
| Comportamiento | Detalle |
|---|---|
| Caché de descubrimiento | Resultados en caché durante 1 hora |
| Actualización de token IAM | Cada hora |
Para mantener habilitado el Plugin de Mantle pero suprimir el descubrimiento automático y la generación de bearer tokens de IAM, deshabilita el selector de descubrimiento propiedad del Plugin:
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled falseRegiones 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
Si prefieres 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
Reasoning support
El soporte de razonamiento se infiere a partir de IDs de modelo que contienen patrones como
thinking, reasoner o gpt-oss-120b. OpenClaw define reasoning: true
automáticamente para los modelos coincidentes durante el descubrimiento.
Endpoint unavailability
Si el endpoint de Mantle no está disponible o no devuelve modelos, el proveedor se omite silenciosamente. OpenClaw no genera un error; otros proveedores configurados continúan funcionando normalmente.
Claude Opus 4.7 via the Anthropic Messages route
Mantle también expone una ruta de Anthropic Messages que transporta modelos Claude mediante la misma ruta de streaming autenticada con bearer token. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) se puede invocar mediante esta ruta con streaming propiedad del proveedor, por lo que los bearer tokens de AWS no se tratan como claves de API de Anthropic.
Cuando fijas un modelo de Anthropic Messages en el proveedor Mantle, OpenClaw usa la superficie de API anthropic-messages en lugar de openai-completions para ese modelo. La autenticación sigue viniendo de AWS_BEARER_TOKEN_BEDROCK (o del bearer token de IAM creado).
{ 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, }, ], }, }, },}Relationship to Amazon Bedrock provider
Bedrock Mantle es un proveedor separado del proveedor estándar
Amazon Bedrock. Mantle usa una superficie /v1
compatible con OpenAI, mientras que el proveedor estándar de Bedrock usa
la API nativa de Bedrock.
Ambos proveedores comparten la misma credencial AWS_BEARER_TOKEN_BEDROCK cuando
está presente.
Relacionado
Proveedor nativo de Bedrock para Anthropic Claude, Titan y otros modelos.
Elegir proveedores, referencias de modelo y comportamiento de conmutación por error.
Detalles de autenticación y reglas de reutilización de credenciales.
Problemas comunes y cómo resolverlos.
