---
read_when:
    - Quieres usar modelos OSS alojados en Bedrock Mantle con OpenClaw
    - Necesitas el punto de conexión compatible con OpenAI de Mantle para GPT-OSS, Qwen, Kimi o GLM
summary: Usa modelos de Amazon Bedrock Mantle (compatibles con OpenAI) con OpenClaw
title: Amazon Bedrock Mantle
x-i18n:
    generated_at: "2026-05-11T20:49:33Z"
    model: gpt-5.5
    provider: openai
    source_hash: 721eef5b7ff606b8c5e02234dae1b8d846b43ff9f3d7bf871f701bb3136fec0e
    source_path: providers/bedrock-mantle.md
    workflow: 16
---

OpenClaw incluye un proveedor **Amazon Bedrock Mantle** incluido 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 Anthropic Messages)          |
| Autenticación         | `AWS_BEARER_TOKEN_BEDROCK` explícito o generación de token portador mediante la cadena de credenciales 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.

<Tabs>
  <Tab title="Token portador explícito">
    **Recomendado para:** entornos donde ya tienes un token portador de Mantle.

    <Steps>
      <Step title="Configurar el token portador en el host del Gateway">
        ```bash
        export AWS_BEARER_TOKEN_BEDROCK="..."
        ```

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

        ```bash
        export AWS_REGION="us-west-2"
        ```
      </Step>
      <Step title="Verificar que se descubren modelos">
        ```bash
        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.
      </Step>
    </Steps>

  </Tab>

  <Tab title="Credenciales IAM">
    **Recomendado para:** usar credenciales compatibles con AWS SDK (configuración compartida, SSO, identidad web, roles de instancia o de tarea).

    <Steps>
      <Step title="Configurar credenciales de AWS en el host del Gateway">
        Funciona cualquier origen de autenticación compatible con AWS SDK:

        ```bash
        export AWS_PROFILE="default"
        export AWS_REGION="us-west-2"
        ```
      </Step>
      <Step title="Verificar que se descubren modelos">
        ```bash
        openclaw models list
        ```

        OpenClaw genera automáticamente un token portador de Mantle a partir de la cadena de credenciales.
      </Step>
    </Steps>

    <Tip>
    Cuando `AWS_BEARER_TOKEN_BEDROCK` no está configurado, OpenClaw emite el token portador por ti a partir de la cadena de credenciales predeterminada de AWS, incluidos perfiles de credenciales/configuración compartidos, SSO, identidad web y roles de instancia o de tarea.
    </Tip>

  </Tab>
</Tabs>

## Descubrimiento automático de modelos

Cuando `AWS_BEARER_TOKEN_BEDROCK` está configurado, OpenClaw lo usa directamente. De lo contrario,
OpenClaw intenta generar un token portador 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 almacenados en caché durante 1 hora |
| Actualización de token IAM | Cada hora                    |

Para mantener habilitado el plugin Mantle pero suprimir el descubrimiento automático y la
generación de tokens portadores IAM, deshabilita el interruptor de descubrimiento propiedad del plugin:

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

<Note>
El token portador es el mismo `AWS_BEARER_TOKEN_BEDROCK` que usa el proveedor estándar [Amazon Bedrock](/es/providers/bedrock).
</Note>

### 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 configuración explícita en lugar de descubrimiento automático:

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

## Configuración avanzada

<AccordionGroup>
  <Accordion title="Soporte de razonamiento">
    El soporte de razonamiento se infiere a partir de 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.
  </Accordion>

  <Accordion title="Endpoint no disponible">
    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
    siguen funcionando con normalidad.
  </Accordion>

  <Accordion title="Claude Opus 4.7 mediante la ruta Anthropic Messages">
    Mantle también expone una ruta Anthropic Messages que transporta modelos Claude por la misma ruta de streaming autenticada con token portador. 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 tokens portadores de AWS no se tratan como claves de API de Anthropic.

    Cuando fijas un modelo 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 token portador IAM emitido).

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

  </Accordion>

  <Accordion title="Relación con el proveedor Amazon Bedrock">
    Bedrock Mantle es un proveedor separado del proveedor estándar
    [Amazon Bedrock](/es/providers/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.

  </Accordion>
</AccordionGroup>

## Relacionado

<CardGroup cols={2}>
  <Card title="Amazon Bedrock" href="/es/providers/bedrock" icon="cloud">
    Proveedor nativo de Bedrock para Anthropic Claude, Titan y otros modelos.
  </Card>
  <Card title="Selección de modelo" href="/es/concepts/model-providers" icon="layers">
    Elección de proveedores, refs de modelo y comportamiento de conmutación por error.
  </Card>
  <Card title="OAuth y autenticación" href="/es/gateway/authentication" icon="key">
    Detalles de autenticación y reglas de reutilización de credenciales.
  </Card>
  <Card title="Solución de problemas" href="/es/help/troubleshooting" icon="wrench">
    Problemas comunes y cómo resolverlos.
  </Card>
</CardGroup>