/v1/chat/completions surface backed by Bedrock infrastructure. Mantle also
exposes Anthropic Claude models through an Anthropic Messages route.
| Property | Value |
|---|---|
| Provider ID | amazon-bedrock-mantle |
| API | openai-completions for discovered OSS models, anthropic-messages for Claude models |
| Auth | Explicit AWS_BEARER_TOKEN_BEDROCK or IAM credential-chain bearer-token generation |
| Default region | us-east-1 (override with AWS_REGION or AWS_DEFAULT_REGION) |
Getting started
Choose your preferred auth method and follow the setup steps.- Explicit bearer token
- IAM credentials
Best for: environments where you already have a Mantle bearer token.
Automatic model discovery
WhenAWS_BEARER_TOKEN_BEDROCK is set, OpenClaw uses it directly. Otherwise,
OpenClaw attempts to generate a Mantle bearer token from the AWS default
credential chain. It then discovers available Mantle models by querying the
region’s /v1/models endpoint.
| Behavior | Detail |
|---|---|
| Discovery cache | Results cached for 1 hour per region; a fetch failure returns the last cached result |
| IAM token refresh | Every 2 hours, cached per region |
The bearer token is the same
AWS_BEARER_TOKEN_BEDROCK used by the standard Amazon Bedrock provider.Supported regions
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.
Manual configuration
If you prefer explicit config instead of auto-discovery:models list is authoritative and replaces every
discovered row, including the Claude rows below. Omit models to retain the
automatic Mantle catalog, or include the complete Claude model entries you
want to use.
Advanced configuration
Reasoning support
Reasoning support
Reasoning support is inferred from model IDs containing patterns like
thinking, reasoner, reasoning, deepseek.r, gpt-oss-120b, or
gpt-oss-safeguard-120b. OpenClaw sets reasoning: true automatically for
matching models during discovery.Claude via the Anthropic Messages route
Claude via the Anthropic Messages route
When automatic discovery owns the model list, OpenClaw appends four Claude
models after a successful lookup, regardless of what
/v1/models returns:
amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5),
amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7), and
amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5), plus
amazon-bedrock-mantle/anthropic.claude-mythos-preview (Claude Mythos
Preview). They use the anthropic-messages API surface and stream through
the same bearer-authenticated Anthropic-compatible endpoint
(<mantle-base>/anthropic), so the AWS bearer token is not treated like an
Anthropic API key.Claude Sonnet 5 always uses adaptive thinking and defaults to high
effort. /think off and /think minimal map to low because the Mantle
route cannot disable thinking. OpenClaw also omits custom temperature for
Sonnet 5 requests.Claude Mythos 5 is limited access. It publishes a 1,000,000-token context
window and 128,000-token output limit, always uses adaptive thinking, maps
/think off and /think minimal to low, and omits caller-selected
sampling parameters.Claude Mythos Preview always requests reasoning, defaulting to high
effort when no /think level is set (mapped from xhigh/max down to
high, and minimal up to low). Opus 4.7 on Mantle streams without
model-provided reasoning, and OpenClaw omits its temperature parameter
since Opus 4.7 does not accept sampling overrides on this route; Mythos
Preview accepts a temperature override normally.A non-empty explicit models.providers["amazon-bedrock-mantle"].models
list replaces the complete discovered catalog. Omit that list when you
want these built-in Claude rows.Relationship to Amazon Bedrock provider
Relationship to Amazon Bedrock provider
Bedrock Mantle is a separate provider from the standard
Amazon Bedrock provider. Mantle uses an
OpenAI-compatible
/v1 surface for its OSS catalog, while the standard
Bedrock provider uses the native Bedrock Converse API.Both providers share the same AWS_BEARER_TOKEN_BEDROCK credential when
present.Related
Amazon Bedrock
Native Bedrock provider for Anthropic Claude, Titan, and other models.
Model selection
Choosing providers, model refs, and failover behavior.
OAuth and auth
Auth details and credential reuse rules.
Troubleshooting
Common issues and how to resolve them.