Amazon Bedrock Mantle Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: Amazon Bedrock Mantle

개요

이 페이지는 OpenClaw Amazon Bedrock Mantle provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Use Amazon Bedrock Mantle OpenAI-compatible and Claude Messages models with OpenClaw

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

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`)

공식 문서 기반 상세

아래는 공식 providers/bedrock-mantle 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

OpenClaw includes a bundled Amazon Bedrock Mantle provider that connects to the Mantle OpenAI-compatible endpoint. Mantle hosts open-source and third-party models (GPT-OSS, Qwen, Kimi, GLM, and similar) through a standard /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`)

시작하기

Choose your preferred auth method and follow the setup steps.

**Best for:** environments where you already have a Mantle bearer token.

Set the bearer token on the gateway host

    ```bash
    export AWS_BEARER_TOKEN_BEDROCK="..."
    ```

    Optionally set a region (defaults to `us-east-1`):

    ```bash
    export AWS_REGION="us-west-2"
    ```

Verify models are discovered

    ```bash
    openclaw models list
    ```

    Discovered models appear under the `amazon-bedrock-mantle` provider. No
    additional config is required unless you want to override defaults.
  






**Best for:** using AWS SDK-compatible credentials (shared config, SSO, web identity, instance or task roles).

Configure AWS credentials on the gateway host

    Any AWS SDK-compatible auth source works:

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

Verify models are discovered

    ```bash
    openclaw models list
    ```

    OpenClaw generates a Mantle bearer token from the credential chain automatically.

When AWS_BEARER_TOKEN_BEDROCK is not set, OpenClaw mints the bearer token for you from the AWS default credential chain, including shared credentials/config profiles, SSO, web identity, and instance or task roles.

Automatic model discovery

When AWS_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

To keep the Mantle plugin enabled but suppress automatic discovery and IAM bearer-token generation, disable the plugin-owned discovery toggle:

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

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

An explicit non-empty 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.

고급 설정

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.

Endpoint unavailability

If the Mantle endpoint is unavailable, returns no models, or bearer-token
resolution fails, discovery returns an empty result and the implicit
provider is skipped. OpenClaw does not error; other configured providers
continue to work normally.

Claude via the Anthropic Messages route

When automatic discovery owns the model list, OpenClaw appends five Claude
models after a successful lookup, regardless of what `/v1/models` returns:
`amazon-bedrock-mantle/anthropic.claude-opus-5` (Claude Opus 5),
`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 Opus 5 publishes a 1,000,000-token context window, 128,000-token
output limit, image input, and `$5/$25` input/output pricing. Adaptive
thinking defaults to `high`; `/think off` disables thinking, and
`/think xhigh|max` uses the model's native effort levels. OpenClaw omits
caller-selected sampling parameters.

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

Bedrock Mantle is a separate provider from the standard
[Amazon Bedrock](https://docs.openclaw.ai/providers/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.

검증 체크리스트

openclaw models list --provider bedrock-mantle 로 모델이 보이는지 확인
기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

Amazon Bedrock Mantle Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: Amazon Bedrock Mantle

개요

이 페이지는 OpenClaw Amazon Bedrock Mantle provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Use Amazon Bedrock Mantle OpenAI-compatible and Claude Messages models with OpenClaw

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

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`)

공식 문서 기반 상세

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`)

시작하기

Choose your preferred auth method and follow the setup steps.

**Best for:** environments where you already have a Mantle bearer token.

Set the bearer token on the gateway host

    ```bash
    export AWS_BEARER_TOKEN_BEDROCK="..."
    ```

    Optionally set a region (defaults to `us-east-1`):

    ```bash
    export AWS_REGION="us-west-2"
    ```

Verify models are discovered

    ```bash
    openclaw models list
    ```

    Discovered models appear under the `amazon-bedrock-mantle` provider. No
    additional config is required unless you want to override defaults.
  






**Best for:** using AWS SDK-compatible credentials (shared config, SSO, web identity, instance or task roles).

Configure AWS credentials on the gateway host

    Any AWS SDK-compatible auth source works:

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

Verify models are discovered

    ```bash
    openclaw models list
    ```

    OpenClaw generates a Mantle bearer token from the credential chain automatically.

When AWS_BEARER_TOKEN_BEDROCK is not set, OpenClaw mints the bearer token for you from the AWS default credential chain, including shared credentials/config profiles, SSO, web identity, and instance or task roles.

Automatic model discovery

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

To keep the Mantle plugin enabled but suppress automatic discovery and IAM bearer-token generation, disable the plugin-owned discovery toggle:

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

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

고급 설정

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.

Endpoint unavailability

If the Mantle endpoint is unavailable, returns no models, or bearer-token
resolution fails, discovery returns an empty result and the implicit
provider is skipped. OpenClaw does not error; other configured providers
continue to work normally.

Claude via the Anthropic Messages route

When automatic discovery owns the model list, OpenClaw appends five Claude
models after a successful lookup, regardless of what `/v1/models` returns:
`amazon-bedrock-mantle/anthropic.claude-opus-5` (Claude Opus 5),
`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 Opus 5 publishes a 1,000,000-token context window, 128,000-token
output limit, image input, and `$5/$25` input/output pricing. Adaptive
thinking defaults to `high`; `/think off` disables thinking, and
`/think xhigh|max` uses the model's native effort levels. OpenClaw omits
caller-selected sampling parameters.

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

Bedrock Mantle is a separate provider from the standard
[Amazon Bedrock](https://docs.openclaw.ai/providers/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.

검증 체크리스트

openclaw models list --provider bedrock-mantle 로 모델이 보이는지 확인
기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

Amazon Bedrock Mantle Provider

개요

빠른 참조

공식 문서 기반 상세

시작하기

Set the bearer token on the gateway host

Verify models are discovered

Configure AWS credentials on the gateway host

Verify models are discovered

Automatic model discovery

Supported regions

Manual configuration

고급 설정

Reasoning support

Endpoint unavailability

Claude via the Anthropic Messages route

Relationship to Amazon Bedrock provider

관련 문서

검증 체크리스트

관련

관련 가이드

Amazon Bedrock Mantle Provider

개요

빠른 참조

공식 문서 기반 상세

시작하기

Set the bearer token on the gateway host

Verify models are discovered

Configure AWS credentials on the gateway host

Verify models are discovered

Automatic model discovery

Supported regions

Manual configuration

고급 설정

Reasoning support

Endpoint unavailability

Claude via the Anthropic Messages route

Relationship to Amazon Bedrock provider

관련 문서

검증 체크리스트

관련

관련 가이드