Providers
Amazon Bedrock Mantle
OpenClaw inclui um provedor Amazon Bedrock Mantle integrado que se conecta ao
endpoint compatível com OpenAI da Mantle. A Mantle hospeda modelos open-source e
de terceiros (GPT-OSS, Qwen, Kimi, GLM e similares) por meio de uma superfície
/v1/chat/completions padrão respaldada pela infraestrutura Bedrock.
| Propriedade | Valor |
|---|---|
| ID do provedor | amazon-bedrock-mantle |
| API | openai-completions (compatível com OpenAI) ou anthropic-messages (rota Anthropic Messages) |
| Autenticação | AWS_BEARER_TOKEN_BEDROCK explícito ou geração de token bearer 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 bearer explícito
Melhor para: ambientes em que você já tem um token bearer da Mantle.
Defina o token bearer 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"Aceite o compartilhamento de dados do provedor para Claude Fable 5
Claude Fable 5 e modelos Bedrock da classe Claude Mythos exigem o modo provider_data_share da API Mantle Data Retention antes da invocação. Esse aceite permite que o Bedrock compartilhe prompts e conclusões com a Anthropic e os retenha por até 30 dias para análise de confiança e segurança.
AWS_REGION="${AWS_REGION:-us-east-1}"curl -X PUT "https://bedrock-mantle.${AWS_REGION}.api.aws/v1/data_retention" \ -H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK" \ -H "Content-Type: application/json" \ -d '{ "mode": "provider_data_share" }'Use outro modelo Bedrock na configuração se você não puder aceitar esse modo de retenção.
Verifique se os modelos foram descobertos
openclaw models listOs modelos descobertos aparecem sob o provedor amazon-bedrock-mantle. Nenhuma
configuração adicional é necessária, a menos que você queira substituir os padrões.
Credenciais IAM
Melhor para: usar credenciais compatíveis com AWS SDK (configuração compartilhada, SSO, identidade da Web, funções de instância ou tarefa).
Configure as credenciais AWS no host do gateway
Qualquer origem de autenticação compatível com AWS SDK funciona:
export AWS_PROFILE="default"export AWS_REGION="us-west-2"Verifique se os modelos foram descobertos
openclaw models listOpenClaw gera automaticamente um token bearer da Mantle a partir da cadeia de credenciais.
Descoberta automática de modelos
Quando AWS_BEARER_TOKEN_BEDROCK está definido, OpenClaw o usa diretamente. Caso contrário,
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.
| Comportamento | Detalhe |
|---|---|
| Cache de descoberta | Resultados em cache por 1 hora |
| Atualização de token IAM | A cada hora |
Para manter o Plugin Mantle habilitado, mas suprimir a descoberta automática e a geração de token bearer IAM, desative o alternador de descoberta pertencente ao Plugin:
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled falseRegiõ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
Suporte a raciocínio
O suporte a raciocínio é inferido a partir de IDs de modelos que contêm padrões como
thinking, reasoner ou gpt-oss-120b. OpenClaw define reasoning: true
automaticamente para modelos correspondentes durante a descoberta.
Indisponibilidade do endpoint
Se o endpoint Mantle estiver indisponível ou não retornar modelos, o provedor será ignorado silenciosamente. OpenClaw não gera erro; outros provedores configurados continuam funcionando normalmente.
Claude Opus 4.7 pela rota Anthropic Messages
Mantle também expõe uma rota Anthropic Messages que transporta modelos Claude pelo mesmo caminho de streaming autenticado por bearer. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) pode ser chamado por essa rota com streaming gerenciado pelo provedor, portanto 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, 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, }, ], }, }, },}Relação com o provedor Amazon Bedrock
Bedrock Mantle é um provedor separado do provedor
Amazon Bedrock padrão. Mantle usa uma superfície
/v1 compatível com OpenAI, enquanto o provedor Bedrock padrão usa
a API Bedrock nativa.
Ambos os provedores compartilham a mesma credencial AWS_BEARER_TOKEN_BEDROCK quando
presente.
Relacionados
Provedor Bedrock nativo para Anthropic Claude, Titan e outros modelos.
Escolha de provedores, referências de modelo e comportamento de failover.
Detalhes de autenticação e regras de reutilização de credenciais.
Problemas comuns e como resolvê-los.
