快速开始
Amazon 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 网关主机上设置持有者令牌
export AWS_BEARER_TOKEN_BEDROCK="..."也可以设置区域（默认为 us-east-1）：
export AWS_REGION="us-west-2"验证是否已发现模型
openclaw models list已发现的模型会显示在 amazon-bedrock-mantle 提供商下。除非你想覆盖默认设置，否则无需其他配置。
IAM 凭证
最适合： 使用与 AWS SDK 兼容的凭证（共享配置、SSO、Web 身份、实例角色或任务角色）。
在 Gateway 网关主机上配置 AWS 凭证
可以使用任何与 AWS SDK 兼容的身份验证来源：
export AWS_PROFILE="default"export AWS_REGION="us-west-2"验证是否已发现模型
openclaw models listOpenClaw 会自动通过凭证链生成 Mantle 持有者令牌。
自动发现模型
设置 AWS_BEARER_TOKEN_BEDROCK 后，OpenClaw 会直接使用它。否则，OpenClaw 会尝试通过 AWS 默认凭证链生成 Mantle 持有者令牌。随后，它会查询该区域的 /v1/models 端点，以发现可用的 Mantle 模型。
| 行为 | 详情 |
|---|---|
| 发现缓存 | 结果按区域缓存 1 小时；获取失败时返回最后一次缓存的结果 |
| IAM 令牌刷新 | 每 2 小时刷新一次，按区域缓存 |
若要保持启用 Mantle 插件，但禁止自动发现和生成 IAM 持有者令牌，请禁用该插件自有的发现开关：
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false支持的区域
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。
手动配置
如果你偏好使用显式配置而非自动发现：
{ 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 模型条目。
高级配置
推理支持
OpenClaw 会根据模型 ID 是否包含 thinking、reasoner、reasoning、deepseek.r、gpt-oss-120b 或 gpt-oss-safeguard-120b 等模式来推断推理支持。在发现过程中，OpenClaw 会自动为匹配的模型设置 reasoning: true。
端点不可用
如果 Mantle 端点不可用、未返回任何模型，或持有者令牌解析失败，发现操作会返回空结果，并跳过隐式提供商。OpenClaw 不会报错；其他已配置的提供商会继续正常工作。
通过 Anthropic Messages 路由使用 Claude
当模型列表由自动发现管理时，成功查询后，无论 /v1/models 返回什么内容，OpenClaw 都会追加四个 Claude 模型：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 密钥。
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 条目，请省略该列表。
与 Amazon Bedrock 提供商的关系
Bedrock Mantle 与标准 Amazon Bedrock 提供商是两个独立的提供商。Mantle 为其 OSS 目录使用与 OpenAI 兼容的 /v1 接口，而标准 Bedrock 提供商使用原生 Bedrock Converse API。
如果存在 AWS_BEARER_TOKEN_BEDROCK 凭证，两个提供商会共用该凭证。
