> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon Bedrock Mantle

OpenClaw 包含一个内置的 **Amazon Bedrock Mantle** 提供方，可连接到
Mantle OpenAI 兼容端点。Mantle 通过由 Bedrock 基础设施支持的标准
`/v1/chat/completions` 接口托管开源和
第三方模型（GPT-OSS、Qwen、Kimi、GLM 及类似模型）。Mantle 还
通过 Anthropic Messages 路由公开 Anthropic Claude 模型。

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

## 入门

选择你偏好的认证方式并按照设置步骤进行。

<Tabs>
  <Tab title="显式 bearer token">
    **最适合：** 你已经拥有 Mantle bearer token 的环境。

    <Steps>
      <Step title="在网关主机上设置 bearer token">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        export AWS_BEARER_TOKEN_BEDROCK="..."
        ```

        可选地设置区域（默认值为 `us-east-1`）：

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        export AWS_REGION="us-west-2"
        ```
      </Step>

      <Step title="验证模型已被发现">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list
        ```

        发现的模型会显示在 `amazon-bedrock-mantle` 提供程序下。除非你想覆盖默认值，否则不需要额外配置。
      </Step>
    </Steps>
  </Tab>

  <Tab title="IAM 凭证">
    **最适合：** 使用与 AWS SDK 兼容的凭证（共享配置、SSO、Web Identity、实例或任务角色）。

    <Steps>
      <Step title="在网关主机上配置 AWS 凭证">
        任何与 AWS SDK 兼容的认证源都可以：

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        export AWS_PROFILE="default"
        export AWS_REGION="us-west-2"
        ```
      </Step>

      <Step title="验证模型已被发现">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list
        ```

        OpenClaw 会自动从凭证链生成 Mantle bearer token。
      </Step>
    </Steps>

    <Tip>
      当未设置 `AWS_BEARER_TOKEN_BEDROCK` 时，OpenClaw 会从 AWS 默认凭证链为你生成 bearer token，包括共享凭证/配置文件、SSO、Web Identity，以及实例或任务角色。
    </Tip>
  </Tab>
</Tabs>

## 自动模型发现

当设置了 `AWS_BEARER_TOKEN_BEDROCK` 时，OpenClaw 会直接使用它。否则，
OpenClaw 会尝试从 AWS 默认凭证链生成 Mantle bearer token。然后它会通过查询
该区域的 `/v1/models` 端点来发现可用的 Mantle 模型。

| 行为           | 详情                             |
| ------------ | ------------------------------ |
| 发现缓存         | 结果会按每个区域缓存 1 小时；获取失败时返回上次缓存的结果 |
| IAM token 刷新 | 每 2 小时一次，按每个区域缓存               |

要保持 Mantle 插件启用，但禁止自动发现和 IAM
bearer token 生成，请禁用由插件拥有的发现开关：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false
```

<Note>
  bearer token 与标准 [Amazon Bedrock](/providers/bedrock) 提供程序使用的 `AWS_BEARER_TOKEN_BEDROCK` 相同。
</Note>

### 支持的区域

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

## 手动配置

如果你更喜欢显式配置而不是自动发现：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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,
          },
        ],
      },
    },
  },
}
```

一个显式且非空的 `models` 列表具有权威性，并会替换所有
已发现的行，包括下面的 Claude 行。省略 `models` 以保留
自动的 Mantle 目录，或者包含你想使用的完整 Claude 模型条目。

## 高级配置

<AccordionGroup>
  <Accordion title="推理支持">
    推理支持是根据模型 ID 中包含的模式推断出来的，例如
    `thinking`、`reasoner`、`reasoning`、`deepseek.r`、`gpt-oss-120b` 或
    `gpt-oss-safeguard-120b`。OpenClaw 在发现阶段会自动为匹配的模型设置
    `reasoning: true`。
  </Accordion>

  <Accordion title="端点不可用">
    如果 Mantle 端点不可用、未返回任何模型，或者 bearer token 解析失败，
    则发现过程会返回空结果，并跳过隐式提供程序。OpenClaw 不会报错；其他已配置的提供程序
    会继续正常工作。
  </Accordion>

  <Accordion title="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 为限量访问。它提供 1,000,000 token 的上下文窗口和 128,000 token 的输出上限，
    始终使用自适应思考，`/think off` 和 `/think minimal` 映射为 `low`，
    并省略调用方选择的采样参数。

    Claude Mythos Preview 始终请求推理，在未设置 `/think` 级别时默认使用 `high`
    努力级别（从 `xhigh`/`max` 映射为 `high`，从 `minimal` 映射为 `low`）。Mantle 上的 Opus 4.7
    会在不带模型提供的推理的情况下流式传输，并且 OpenClaw 会省略其 `temperature`
    参数，因为 Opus 4.7 在此路由上不接受采样覆盖；Mythos Preview 正常接受
    `temperature` 覆盖。

    非空的显式 `models.providers["amazon-bedrock-mantle"].models`
    列表会替换完整的已发现目录。当你想要这些内置 Claude 行时，请省略该列表。
  </Accordion>

  <Accordion title="与 Amazon Bedrock 提供程序的关系">
    Bedrock Mantle 是一个独立于标准
    [Amazon Bedrock](/providers/bedrock) 提供程序的提供程序。Mantle 为其 OSS 目录使用
    兼容 OpenAI 的 `/v1` 接口，而标准 Bedrock 提供程序使用原生的 Bedrock Converse API。

    当存在时，这两个提供程序共享同一个 `AWS_BEARER_TOKEN_BEDROCK` 凭证。
  </Accordion>
</AccordionGroup>

## 相关内容

<CardGroup cols={2}>
  <Card title="Amazon Bedrock" href="/providers/bedrock" icon="cloud">
    用于 Anthropic Claude、Titan 和其他模型的原生 Bedrock 提供程序。
  </Card>

  <Card title="模型选择" href="/concepts/model-providers" icon="layers">
    选择提供程序、模型引用和故障转移行为。
  </Card>

  <Card title="OAuth 和认证" href="/gateway/authentication" icon="key">
    认证详情和凭证复用规则。
  </Card>

  <Card title="故障排查" href="/help/troubleshooting" icon="wrench">
    常见问题及其解决方法。
  </Card>
</CardGroup>