Amazon Bedrock Mantle

O OpenClaw inclui um provedor Amazon Bedrock Mantle integrado que se conecta ao endpoint compatível com OpenAI do Mantle. O Mantle hospeda modelos de código aberto e de terceiros (GPT-OSS, Qwen, Kimi, GLM e semelhantes) por meio de uma interface padrão /v1/chat/completions, respaldada pela infraestrutura do Bedrock. O Mantle também disponibiliza modelos Anthropic Claude por meio de uma rota Anthropic Messages.

Propriedade	Valor
ID do provedor	`amazon-bedrock-mantle`
API	`openai-completions` para modelos OSS descobertos, `anthropic-messages` para modelos Claude
Autenticação	`AWS_BEARER_TOKEN_BEDROCK` explícito ou geração de token de portador pela cadeia de credenciais do IAM
Região padrão	`us-east-1` (substitua com `AWS_REGION` ou `AWS_DEFAULT_REGION`)

Primeiros passos

Escolha seu método de autenticação preferido e siga as etapas de configuração.

Token de portador explícito
Credenciais do IAM

Ideal para: ambientes nos quais você já tem um token de portador do Mantle.

Defina o token de portador no host do Gateway

export AWS_BEARER_TOKEN_BEDROCK="..."

Opcionalmente, defina uma região (o padrão é us-east-1):

export AWS_REGION="us-west-2"

Verifique se os modelos foram descobertos

openclaw models list

Os modelos descobertos aparecem no provedor amazon-bedrock-mantle. Nenhuma configuração adicional é necessária, a menos que você queira substituir os padrões.

Ideal para: usar credenciais compatíveis com o AWS SDK (configuração compartilhada, SSO, identidade da Web, funções de instância ou de tarefa).

Configure as credenciais da AWS no host do Gateway

Qualquer fonte de autenticação compatível com o AWS SDK funciona:

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

Verifique se os modelos foram descobertos

openclaw models list

O OpenClaw gera automaticamente um token de portador do Mantle usando a cadeia de credenciais.

Quando AWS_BEARER_TOKEN_BEDROCK não está definido, o OpenClaw gera o token de portador para você usando a cadeia de credenciais padrão da AWS, incluindo credenciais compartilhadas, perfis de configuração, SSO, identidade da Web e funções de instância ou de tarefa.

Descoberta automática de modelos

Quando AWS_BEARER_TOKEN_BEDROCK está definido, o OpenClaw o utiliza diretamente. Caso contrário, o OpenClaw tenta gerar um token de portador do Mantle usando a cadeia de credenciais padrão da AWS. Em seguida, ele descobre os modelos disponíveis do Mantle consultando o endpoint /v1/models da região.

Comportamento	Detalhes
Cache de descoberta	Os resultados são armazenados em cache por 1 hora para cada região; uma falha na busca retorna o último resultado armazenado em cache
Atualização do token do IAM	A cada 2 horas, com cache separado por região

Para manter o Plugin do Mantle ativado, mas suprimir a descoberta automática e a geração do token de portador do IAM, desative a opção de descoberta pertencente ao Plugin:

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

O token de portador é o mesmo AWS_BEARER_TOKEN_BEDROCK usado pelo provedor padrão Amazon Bedrock.

Regiões compatíveis

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.

Configuração manual

Se você preferir uma configuração explícita em vez da descoberta 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,
          },
        ],
      },
    },
  },
}

Uma lista models explícita e não vazia é a fonte autoritativa e substitui todas as entradas descobertas, incluindo as entradas do Claude abaixo. Omita models para manter o catálogo automático do Mantle ou inclua todas as entradas de modelos Claude que você deseja usar.

Configuração avançada

Suporte a raciocínio

O suporte a raciocínio é inferido de IDs de modelos que contêm padrões como thinking, reasoner, reasoning, deepseek.r, gpt-oss-120b ou gpt-oss-safeguard-120b. O OpenClaw define automaticamente reasoning: true para os modelos correspondentes durante a descoberta.

Indisponibilidade do endpoint

Se o endpoint do Mantle estiver indisponível, não retornar modelos ou se a resolução do token de portador falhar, a descoberta retornará um resultado vazio e o provedor implícito será ignorado. O OpenClaw não gera um erro; os outros provedores configurados continuam funcionando normalmente.

Claude pela rota Anthropic Messages

Quando a descoberta automática controla a lista de modelos, o OpenClaw acrescenta quatro modelos Claude após uma consulta bem-sucedida, independentemente do que /v1/models retornar: amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5), amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7) e amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5), além de amazon-bedrock-mantle/anthropic.claude-mythos-preview (Claude Mythos Preview). Eles usam a interface da API anthropic-messages e transmitem pelo mesmo endpoint compatível com Anthropic e autenticado por token de portador (<mantle-base>/anthropic), portanto o token de portador da AWS não é tratado como uma chave de API da Anthropic.O Claude Sonnet 5 sempre usa raciocínio adaptativo e adota high como nível de esforço padrão. /think off e /think minimal são mapeados para low porque a rota do Mantle não permite desativar o raciocínio. O OpenClaw também omite uma temperatura personalizada nas solicitações do Sonnet 5.O acesso ao Claude Mythos 5 é limitado. Ele oferece uma janela de contexto de 1.000.000 de tokens e um limite de saída de 128.000 tokens, sempre usa raciocínio adaptativo, mapeia /think off e /think minimal para low e omite os parâmetros de amostragem selecionados pelo chamador.O Claude Mythos Preview sempre solicita raciocínio e adota high como nível de esforço padrão quando nenhum nível de /think está definido (xhigh/max são reduzidos para high, e minimal é elevado para low). O Opus 4.7 no Mantle transmite sem raciocínio fornecido pelo modelo, e o OpenClaw omite seu parâmetro temperature, pois o Opus 4.7 não aceita substituições de amostragem nessa rota; o Mythos Preview aceita normalmente uma substituição de temperature.Uma lista models.providers["amazon-bedrock-mantle"].models explícita e não vazia substitui todo o catálogo descoberto. Omita essa lista quando quiser usar essas entradas integradas do Claude.

Relação com o provedor Amazon Bedrock

O Bedrock Mantle é um provedor separado do provedor padrão Amazon Bedrock. O Mantle usa uma interface /v1 compatível com OpenAI para seu catálogo OSS, enquanto o provedor padrão do Bedrock usa a API nativa Bedrock Converse.Ambos os provedores compartilham a mesma credencial AWS_BEARER_TOKEN_BEDROCK quando ela está presente.

Conteúdo relacionado

Amazon Bedrock

Provedor nativo do Bedrock para Anthropic Claude, Titan e outros modelos.

Seleção de modelos

Como escolher provedores, referências de modelos e o comportamento de failover.

OAuth e autenticação

Detalhes de autenticação e regras de reutilização de credenciais.

Solução de problemas

Problemas comuns e como resolvê-los.

Overview

Concepts and configuration

Providers

Amazon Bedrock Mantle

Primeiros passos

Descoberta automática de modelos

Regiões compatíveis

Configuração manual

Configuração avançada

Conteúdo relacionado

Amazon Bedrock

Seleção de modelos

OAuth e autenticação

Solução de problemas

​Primeiros passos

​Descoberta automática de modelos

​Regiões compatíveis

​Configuração manual

​Configuração avançada

​Conteúdo relacionado

Amazon Bedrock

Seleção de modelos

OAuth e autenticação

Solução de problemas

Primeiros passos

Descoberta automática de modelos

Regiões compatíveis

Configuração manual

Configuração avançada

Conteúdo relacionado