Ir al contenido

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.

PropiedadValor
ID del proveedoramazon-bedrock-mantle
APIopenai-completions (compatible con OpenAI) o anthropic-messages (ruta de mensajes de Anthropic)
AutenticaciónAWS_BEARER_TOKEN_BEDROCK explícito o generación de tokens de portador de la cadena de credenciales de IAM
Región predeterminadaus-east-1 (anular con AWS_REGION o AWS_DEFAULT_REGION)

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.

  1. 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"
  2. Verificar que los modelos se descubren

    Ventana de terminal
    openclaw models list

    Los modelos descubiertos aparecen bajo el proveedor amazon-bedrock-mantle. No se requiere configuración adicional a menos que desees anular los valores predeterminados.

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.

ComportamientoDetalle
Caché de descubrimientoResultados almacenados en caché durante 1 hora
Actualización del token de IAMCada 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:

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

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.

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

Amazon Bedrock

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

Selección de modelo

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 comunes y cómo resolverlos.