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

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

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

  • Defina o token de portador no host do Gateway

    bash
    export AWS_BEARER_TOKEN_BEDROCK="..."

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

    bash
    export AWS_REGION="us-west-2"

  • Verifique se os modelos foram descobertos

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

    • Credenciais do IAM

    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:

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

  • Verifique se os modelos foram descobertos

    bash
    openclaw models list

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

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

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

    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:

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

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

    On this page