# Amazon Bedrock Mantle

> 通过 OpenClaw 使用 Amazon Bedrock Mantle 的 OpenAI 兼容模型和 Claude Messages 模型

- 网址：https://funcoding.ai/agents/openclaw/providers/bedrock-mantle/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/bedrock-mantle

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

| 属性           | 值                                                                                     |
| -------------- | -------------------------------------------------------------------------------------- |
| 提供商 ID      | `amazon-bedrock-mantle`                                                                     |
| API            | 对发现的 OSS 模型使用 `openai-completions`，对 Claude 模型使用 `anthropic-messages`        |
| 身份验证       | 显式 `AWS_BEARER_TOKEN_BEDROCK` 或通过 IAM 凭证链生成持有者令牌                                 |
| 默认区域       | `us-east-1`（可使用 `AWS_REGION` 或 `AWS_DEFAULT_REGION` 覆盖）             |

## 入门指南

选择首选的身份验证方法，然后按照设置步骤操作。

**显式持有者令牌**

**最适合：** 已有 Mantle 持有者令牌的环境。

**在 Gateway 网关主机上设置持有者令牌**

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

还可以选择设置区域（默认为 `us-east-1`）：

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

**验证是否发现模型**

```bash
openclaw models list
```

发现的模型会显示在 `amazon-bedrock-mantle` 提供商下。除非要覆盖默认值，
否则无需其他配置。

**IAM 凭证**

**最适合：** 使用与 AWS SDK 兼容的凭证（共享配置、SSO、Web 身份、实例或任务角色）。

**在 Gateway 网关主机上配置 AWS 凭证**

可使用任何与 AWS SDK 兼容的身份验证来源：

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

**验证是否发现模型**

```bash
openclaw models list
```

OpenClaw 会自动使用凭证链生成 Mantle 持有者令牌。

<div class="callout callout-tip">

未设置 `AWS_BEARER_TOKEN_BEDROCK` 时，OpenClaw 会使用 AWS 默认凭证链为你生成持有者令牌，其中包括共享凭证/配置文件、SSO、Web 身份以及实例或任务角色。

</div>

## 自动发现模型

设置 `AWS_BEARER_TOKEN_BEDROCK` 后，OpenClaw 会直接使用它。否则，
OpenClaw 会尝试使用 AWS 默认凭证链生成 Mantle 持有者令牌。
然后，它会查询相应区域的 `/v1/models` 端点，以发现可用的 Mantle 模型。

| 行为              | 详细信息                                                                          |
| ----------------- | --------------------------------------------------------------------------------- |
| 发现缓存          | 结果按区域缓存 1 小时；获取失败时返回最后一次缓存的结果                           |
| IAM 令牌刷新      | 每 2 小时刷新一次，按区域缓存                                                     |

若要保持 Mantle 插件启用，但禁止自动发现和生成 IAM 持有者令牌，
请禁用插件自有的发现开关：

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

<div class="callout callout-note">

此持有者令牌与标准 [Amazon Bedrock](https://funcoding.ai/agents/openclaw/providers/bedrock/) 提供商使用的 `AWS_BEARER_TOKEN_BEDROCK` 相同。

</div>

### 支持的区域

`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
{
  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 模型条目。

## 高级配置

<details>
<summary>推理支持</summary>

是否支持推理根据模型 ID 中是否包含 `thinking`、
`reasoner`、`reasoning`、`deepseek.r`、`gpt-oss-120b`
或 `gpt-oss-safeguard-120b` 等模式推断。发现过程中，OpenClaw 会自动为
匹配的模型设置 `reasoning: true`。

</details>

<details>
<summary>端点不可用</summary>

如果 Mantle 端点不可用、未返回任何模型或持有者令牌解析失败，
发现过程会返回空结果，并跳过隐式提供商。OpenClaw 不会报错；
其他已配置的提供商将继续正常工作。

</details>

<details>
<summary>通过 Anthropic Messages 路由使用 Claude</summary>

当模型列表由自动发现管理时，OpenClaw 会在成功查询后追加五个 Claude
模型，无论 `/v1/models` 返回什么：
`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）和
`amazon-bedrock-mantle/anthropic.claude-mythos-5`（Claude Mythos 5），以及
`amazon-bedrock-mantle/anthropic.claude-mythos-preview`（Claude Mythos
Preview）。它们使用 `anthropic-messages` API 接口，并通过
同一个使用持有者令牌进行身份验证的 Anthropic 兼容端点
（`<mantle-base>/anthropic`）进行流式传输，因此 AWS 持有者令牌不会被视为
Anthropic API key。

Claude Opus 5 提供 1,000,000 个令牌的上下文窗口、128,000 个令牌的
输出上限、图像输入，以及 `$5/$25` 输入/输出定价。自适应
思考默认为 `high`；`/think off` 会禁用思考，
`/think xhigh|max` 则使用模型原生的投入级别。OpenClaw 会省略
调用方选择的采样参数。

Claude Sonnet 5 始终使用自适应思考，并默认采用 `high`
投入级别。由于 Mantle 路由无法禁用思考，`/think off` 和
`/think minimal` 会映射到 `low`。OpenClaw 还会在
Sonnet 5 请求中省略自定义温度参数。

Claude Mythos 5 仅限受限访问。它提供 1,000,000 个令牌的上下文窗口
和 128,000 个令牌的输出上限，始终使用自适应思考，将
`/think off` 和 `/think minimal` 映射到 `low`，
并省略调用方选择的采样参数。

Claude Mythos Preview 始终请求推理；未设置 `/think`
级别时，默认采用 `high` 投入级别（`xhigh`/`max`
向下映射到 `high`，`minimal` 向上映射到
`low`）。Mantle 上的 Opus 4.7 进行流式传输时不包含
模型提供的推理；由于 Opus 4.7 在此路由上不接受采样覆盖，OpenClaw
会省略其 `temperature` 参数；Mythos Preview 则正常接受
`temperature` 覆盖。

显式且非空的 `models.providers["amazon-bedrock-mantle"].models`
列表会替换完整的发现目录。若要使用这些内置的 Claude 条目，请省略该列表。

</details>

<details>
<summary>与 Amazon Bedrock 提供商的关系</summary>

Bedrock Mantle 与标准 [Amazon Bedrock](https://funcoding.ai/agents/openclaw/providers/bedrock/) 提供商是不同的提供商。
Mantle 为其 OSS 目录使用 OpenAI 兼容的 `/v1` 接口，
而标准 Bedrock 提供商使用原生 Bedrock Converse API。

如果存在 `AWS_BEARER_TOKEN_BEDROCK` 凭证，两个提供商会共享该凭证。

</details>

## 相关内容

- [Amazon Bedrock](https://funcoding.ai/agents/openclaw/providers/bedrock/)：面向 Anthropic Claude、Titan 和其他模型的原生 Bedrock 提供商。
- [模型选择](https://funcoding.ai/agents/openclaw/concepts/model-providers/)：选择提供商、模型引用和故障转移行为。
- [OAuth 和身份验证](https://funcoding.ai/agents/openclaw/gateway/authentication/)：身份验证详情和凭证复用规则。
- [故障排查](https://funcoding.ai/agents/openclaw/help/troubleshooting/)：常见问题及其解决方法。