Pular para o conteúdo principal

​
Amazon Bedrock Mantle

O OpenClaw inclui um provedor agrupado Amazon Bedrock Mantle que se conecta ao endpoint compatível com OpenAI do Mantle. O Mantle hospeda modelos open source e de terceiros (GPT-OSS, Qwen, Kimi, GLM e similares) por meio de uma superfície padrão /v1/chat/completions apoiada pela infraestrutura do Bedrock.
PropriedadeValor
ID do provedoramazon-bedrock-mantle
APIopenai-completions (compatível com OpenAI)
AutenticaçãoAWS_BEARER_TOKEN_BEDROCK explícito ou geração de bearer token pela cadeia de credenciais do IAM
Região padrãous-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.
Ideal para: ambientes em que você já tem um bearer token do Mantle.
1

Defina o bearer token 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"
2

Verifique se os modelos foram descobertos

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

​
Descoberta automática de modelos

Quando AWS_BEARER_TOKEN_BEDROCK está definido, o OpenClaw o usa diretamente. Caso contrário, o OpenClaw tenta gerar um bearer token do Mantle a partir da cadeia de credenciais padrão da AWS. Em seguida, ele descobre os modelos Mantle disponíveis consultando o endpoint regional /v1/models.
ComportamentoDetalhe
Cache de descobertaResultados armazenados por 1 hora
Renovação de token IAMA cada hora
O bearer token é 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 configuração explícita em vez de 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,
          },
        ],
      },
    },
  },
}

​
Notas avançadas

O suporte a raciocínio é inferido a partir de IDs de modelo que contêm padrões como thinking, reasoner ou gpt-oss-120b. O OpenClaw define reasoning: true automaticamente para modelos correspondentes durante a descoberta.
Se o endpoint do Mantle estiver indisponível ou não retornar modelos, o provedor será ignorado silenciosamente. O OpenClaw não gera erro; outros provedores configurados continuam funcionando normalmente.
O Bedrock Mantle é um provedor separado do provedor padrão Amazon Bedrock. O Mantle usa uma superfície /v1 compatível com OpenAI, enquanto o provedor padrão do Bedrock usa a API nativa do Bedrock.Ambos os provedores compartilham a mesma credencial AWS_BEARER_TOKEN_BEDROCK quando presente.

​
Relacionados

Amazon Bedrock

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

Seleção de modelo

Escolha de provedores, refs de modelo e 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.