Saltar al contenido principal
OpenClaw incluye un proveedor Amazon Bedrock Mantle integrado 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) mediante una superficie estándar /v1/chat/completions respaldada por la infraestructura de Bedrock. Mantle también expone dos modelos Anthropic Claude mediante una ruta Anthropic Messages.
PropiedadValor
ID de proveedoramazon-bedrock-mantle
APIopenai-completions para modelos OSS descubiertos, anthropic-messages para los dos modelos Claude
AutenticaciónAWS_BEARER_TOKEN_BEDROCK explícito o generación de token de portador mediante cadena de credenciales IAM
Región predeterminadaus-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.
Mejor para: entornos donde ya tienes un token de portador de Mantle.
1

Set the bearer token on the gateway host

export AWS_BEARER_TOKEN_BEDROCK="..."
Opcionalmente, configura una región (el valor predeterminado es us-east-1):
export AWS_REGION="us-west-2"
2

Verify models are discovered

openclaw models list
Los modelos descubiertos aparecen bajo el proveedor amazon-bedrock-mantle. No se requiere configuración adicional, salvo que quieras sobrescribir los valores predeterminados.

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 de conexión /v1/models de la región.
ComportamientoDetalle
Caché de descubrimientoResultados almacenados en caché durante 1 hora por región; un fallo de obtención devuelve el último resultado almacenado en caché
Actualización de token IAMCada 2 horas, almacenado en caché por región
Para mantener el Plugin de Mantle habilitado pero suprimir el descubrimiento automático y la generación del token de portador IAM, deshabilita el conmutador de descubrimiento 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 usa 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 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

La compatibilidad con 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 reasoning: true automáticamente para los modelos coincidentes durante el descubrimiento.
Si el punto de conexión de Mantle no está disponible, no devuelve modelos o falla la resolución del token de portador, el descubrimiento devuelve un resultado vacío y se omite el proveedor implícito. OpenClaw no genera un error; los demás proveedores configurados siguen funcionando con normalidad.
OpenClaw siempre agrega dos modelos Claude al catálogo de Mantle después de un descubrimiento correcto, independientemente de lo que devuelva /v1/models: amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7) y amazon-bedrock-mantle/anthropic.claude-mythos-preview (Claude Mythos Preview). Ambos usan la superficie de API anthropic-messages y transmiten mediante el mismo punto de conexión compatible con Anthropic autenticado con 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 Mythos Preview siempre solicita razonamiento, con un valor predeterminado de esfuerzo high cuando no se establece ningún nivel /think (mapeado desde xhigh/max hacia high, y desde minimal hacia 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 sobrescrituras de muestreo en esta ruta; Mythos Preview acepta normalmente una sobrescritura de temperature.Estos dos modelos no se pueden configurar mediante entradas models.providers["amazon-bedrock-mantle"].models — siempre los agrega el descubrimiento cuando se completa correctamente, y solo se eliminan deshabilitando el descubrimiento por completo.
Bedrock Mantle es un proveedor independiente del proveedor estándar Amazon Bedrock. Mantle usa una superficie /v1 compatible con OpenAI para su catálogo OSS, mientras que el proveedor estándar Bedrock usa la API nativa Bedrock Converse.Ambos proveedores comparten la misma credencial AWS_BEARER_TOKEN_BEDROCK cuando está presente.

Relacionado

Amazon Bedrock

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

Model selection

Elegir proveedores, referencias de modelo y comportamiento de conmutación por error.

OAuth and auth

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

Troubleshooting

Problemas comunes y cómo resolverlos.