Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw inclui um provedor Amazon Bedrock Mantle integrado que se conecta ao endpoint compatível com OpenAI da Mantle. A Mantle hospeda modelos de código aberto e de terceiros (GPT-OSS, Qwen, Kimi, GLM e similares) por meio de uma superfície padrão /v1/chat/completions apoiada pela infraestrutura da Bedrock.
PropriedadeValor
ID do provedoramazon-bedrock-mantle
APIopenai-completions (compatível com OpenAI) ou anthropic-messages (rota Anthropic Messages)
AutenticaçãoAWS_BEARER_TOKEN_BEDROCK explícito ou geração de token bearer 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 token bearer da Mantle.
1

Set the bearer token on the gateway host

export AWS_BEARER_TOKEN_BEDROCK="..."
Opcionalmente, defina uma região (o padrão é us-east-1):
export AWS_REGION="us-west-2"
2

Verify models are discovered

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 token bearer da Mantle a partir da cadeia de credenciais padrão da AWS. Em seguida, ele descobre os modelos Mantle disponíveis consultando o endpoint /v1/models da região.
ComportamentoDetalhe
Cache de descobertaResultados em cache por 1 hora
Atualização do token IAMA cada hora
Para manter o Plugin Mantle habilitado, mas suprimir a descoberta automática e a geração de token bearer do IAM pertencentes ao Plugin, desabilite a alternância de descoberta pertencente ao Plugin: 
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false
O token bearer é o mesmo AWS_BEARER_TOKEN_BEDROCK usado pelo provedor Amazon Bedrock padrão.

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

​
Configuração avançada

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 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.
A Mantle também expõe uma rota Anthropic Messages que transporta modelos Claude pelo mesmo caminho de streaming autenticado por bearer. O Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) pode ser chamado por essa rota com streaming pertencente ao provedor, portanto os tokens bearer da AWS não são tratados como chaves de API da Anthropic.Quando você fixa um modelo Anthropic Messages no provedor Mantle, o OpenClaw usa a superfície de API anthropic-messages em vez de openai-completions para esse modelo. A autenticação ainda vem de AWS_BEARER_TOKEN_BEDROCK (ou do token bearer IAM emitido).
{
  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,
          },
        ],
      },
    },
  },
}
O Bedrock Mantle é um provedor separado do provedor Amazon Bedrock padrão. A Mantle usa uma superfície /v1 compatível com OpenAI, enquanto o provedor Bedrock padrão usa a API nativa da Bedrock.Ambos os provedores compartilham a mesma credencial AWS_BEARER_TOKEN_BEDROCK quando ela está presente.

​
Relacionados

Amazon Bedrock

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

Model selection

Escolha de provedores, referências de modelo e comportamento de failover.

OAuth and auth

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

Troubleshooting

Problemas comuns e como resolvê-los.