OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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

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

  • Establecer el token de portador en el host del Gateway

    bash
    export AWS_BEARER_TOKEN_BEDROCK="..."

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

    bash
    export AWS_REGION="us-west-2"

  • Verificar que se detectan los modelos

    bash
    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.

    • Credenciales de IAM

    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:

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

  • Verificar que se detectan los modelos

    bash
    openclaw models list

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

    • 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:

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

    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:

    json5
    {  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.
    Was this useful?
    On this page

    On this page