Amazon Bedrock Mantle

OpenClaw incluye un proveedor Amazon Bedrock Mantle integrado que se conecta al endpoint de Mantle compatible con OpenAI. 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. Mantle también expone modelos Anthropic Claude mediante una ruta de Anthropic Messages.

Propiedad	Valor
ID del proveedor	`amazon-bedrock-mantle`
API	`openai-completions` para los modelos OSS detectados, `anthropic-messages` para los modelos Claude
Autenticación	`AWS_BEARER_TOKEN_BEDROCK` explícito o generación de tokens de portador mediante la cadena de credenciales de IAM
Región predeterminada	`us-east-1` (se puede sustituir con `AWS_REGION` o `AWS_DEFAULT_REGION`)

Primeros pasos

Elija el método de autenticación preferido y siga los pasos de configuración.

Token de portador explícito
Credenciales de IAM

Recomendado para: entornos donde ya se dispone de un token de portador de Mantle.

Establecer el token de portador en el host del Gateway

export AWS_BEARER_TOKEN_BEDROCK="..."

Opcionalmente, establezca una región (el valor predeterminado es us-east-1):

export AWS_REGION="us-west-2"

Verificar que se detectan los modelos

openclaw models list

Los modelos detectados aparecen en el proveedor amazon-bedrock-mantle. No se requiere configuración adicional, salvo que se desee sustituir los valores predeterminados.

Recomendado para: usar credenciales compatibles con AWS SDK (configuración compartida, SSO, identidad web y roles de instancia o tarea).

Configurar las credenciales de AWS en el host del Gateway

Se puede usar cualquier fuente de autenticación compatible con AWS SDK:

export AWS_PROFILE="default"
export AWS_REGION="us-west-2"

Verificar que se detectan los modelos

openclaw models list

OpenClaw genera automáticamente un token de portador de Mantle a partir de la cadena de credenciales.

Cuando AWS_BEARER_TOKEN_BEDROCK no está establecido, OpenClaw genera el token de portador a partir de la cadena de credenciales predeterminada de AWS, incluidas las credenciales y los perfiles de configuración compartidos, SSO, la identidad web y los roles de instancia o tarea.

Detección automática de modelos

Cuando AWS_BEARER_TOKEN_BEDROCK está establecido, OpenClaw lo utiliza directamente. De lo contrario, OpenClaw intenta generar un token de portador de Mantle a partir de la cadena de credenciales predeterminada de AWS. A continuación, detecta los modelos de Mantle disponibles consultando el endpoint /v1/models de la región.

Comportamiento	Detalle
Caché de detección	Los resultados se almacenan en caché durante 1 hora por región; si una consulta falla, se devuelve el último resultado almacenado en caché
Renovación del token de IAM	Cada 2 horas, almacenado en caché por región

Para mantener habilitado el Plugin de Mantle, pero desactivar la detección automática y la generación de tokens de portador de IAM, deshabilite la opción de detección propiedad del Plugin:

openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false

El token de portador es el mismo AWS_BEARER_TOKEN_BEDROCK que utiliza el proveedor estándar Amazon Bedrock.

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

Si se prefiere una configuración explícita en lugar de la detección automática:

{
  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,
          },
        ],
      },
    },
  },
}

Una lista models explícita que no esté vacía es la fuente autoritativa y sustituye todas las filas detectadas, incluidas las filas de Claude que aparecen a continuación. Omita models para conservar el catálogo automático de Mantle o incluya las entradas completas de los modelos Claude que se deseen utilizar.

Configuración avanzada

Compatibilidad con el razonamiento

La compatibilidad con el razonamiento se infiere de los ID de modelo que contienen patrones como thinking, reasoner, reasoning, deepseek.r, gpt-oss-120b o gpt-oss-safeguard-120b. OpenClaw establece automáticamente reasoning: true para los modelos coincidentes durante la detección.

Endpoint no disponible

Si el endpoint de Mantle no está disponible, no devuelve modelos o falla la resolución del token de portador, la detección devuelve un resultado vacío y se omite el proveedor implícito. OpenClaw no genera ningún error; los demás proveedores configurados continúan funcionando con normalidad.

Claude mediante la ruta de Anthropic Messages

Cuando la detección automática controla la lista de modelos, OpenClaw añade cinco modelos Claude después de una consulta correcta, independientemente de lo que devuelva /v1/models: amazon-bedrock-mantle/anthropic.claude-opus-5 (Claude Opus 5), amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5), amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7) y amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5), además de amazon-bedrock-mantle/anthropic.claude-mythos-preview (versión preliminar de Claude Mythos Preview). Utilizan la superficie de API anthropic-messages y transmiten mediante el mismo endpoint compatible con Anthropic y autenticado mediante un token de portador (<mantle-base>/anthropic), por lo que el token de portador de AWS no se trata como una clave de API de Anthropic.Claude Opus 5 publica una ventana de contexto de 1,000,000 tokens, un límite de salida de 128,000 tokens, entrada de imágenes y precios de entrada/salida $5/$25. El pensamiento adaptativo utiliza de forma predeterminada high; /think off deshabilita el pensamiento y /think xhigh|max utiliza los niveles de esfuerzo nativos del modelo. OpenClaw omite los parámetros de muestreo seleccionados por el invocador.Claude Sonnet 5 utiliza siempre el pensamiento adaptativo y, de forma predeterminada, un esfuerzo high. /think off y /think minimal se asignan a low porque la ruta de Mantle no permite deshabilitar el pensamiento. OpenClaw también omite la temperatura personalizada en las solicitudes de Sonnet 5.Claude Mythos 5 tiene acceso limitado. Publica una ventana de contexto de 1,000,000 tokens y un límite de salida de 128,000 tokens, utiliza siempre el pensamiento adaptativo, asigna /think off y /think minimal a low y omite los parámetros de muestreo seleccionados por el invocador.Claude Mythos Preview solicita siempre razonamiento y, de forma predeterminada, un esfuerzo high cuando no se establece ningún nivel /think (con xhigh/max asignados hacia abajo a high y minimal hacia arriba a low). Opus 4.7 en Mantle transmite sin razonamiento proporcionado por el modelo, y OpenClaw omite su parámetro temperature porque Opus 4.7 no acepta sustituciones de muestreo en esta ruta; Mythos Preview acepta normalmente una sustitución de temperature.Una lista models.providers["amazon-bedrock-mantle"].models explícita que no esté vacía sustituye el catálogo detectado completo. Omita esa lista cuando se deseen estas filas de Claude integradas.

Relación con el proveedor Amazon Bedrock

Bedrock Mantle es un proveedor independiente del proveedor estándar Amazon Bedrock. Mantle utiliza una superficie /v1 compatible con OpenAI para su catálogo OSS, mientras que el proveedor estándar de Bedrock utiliza la API nativa Bedrock Converse.Ambos proveedores comparten la misma credencial AWS_BEARER_TOKEN_BEDROCK cuando está presente.

Contenido relacionado

Amazon Bedrock

Proveedor nativo de Bedrock para Anthropic Claude, Titan y otros modelos.

Selección de modelos

Elección de proveedores, referencias de modelos y comportamiento de conmutación por error.

OAuth y autenticación

Detalles de autenticación y reglas de reutilización de credenciales.

Solución de problemas

Problemas habituales y cómo resolverlos.

Overview

Concepts and configuration

Providers

Amazon Bedrock Mantle

Primeros pasos

Detección automática de modelos

Regiones compatibles

Configuración manual

Configuración avanzada

Contenido relacionado

Amazon Bedrock

Selección de modelos

OAuth y autenticación

Solución de problemas

​Primeros pasos

​Detección automática de modelos

​Regiones compatibles

​Configuración manual

​Configuración avanzada

​Contenido relacionado

Amazon Bedrock

Selección de modelos

OAuth y autenticación

Solución de problemas

Primeros pasos

Detección automática de modelos

Regiones compatibles

Configuración manual

Configuración avanzada

Contenido relacionado