Amazon Bedrock Mantle

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

属性	值
Provider ID	`amazon-bedrock-mantle`
API	`openai-completions` 用于发现的 OSS 模型，`anthropic-messages` 用于 Claude 模型
认证	显式 `AWS_BEARER_TOKEN_BEDROCK` 或 IAM 凭据链 bearer-token 生成
默认区域	`us-east-1`（使用 `AWS_REGION` 或 `AWS_DEFAULT_REGION` 覆盖）

快速开始¶

选择你偏好的认证方法，然后按照设置步骤操作。

显式 bearer tokenIAM 凭据

**适用于：** 已经拥有 Mantle bearer token 的环境。

1. 在网关主机上设置 bearer token

export AWS_BEARER_TOKEN_BEDROCK="..."

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

export AWS_REGION="us-west-2"

2. 验证模型是否已发现

openclaw models list

发现的模型会出现在 amazon-bedrock-mantle 提供方下。除非你想覆盖默认设置，否则无需额外配置。

**适用于：** 使用兼容 AWS SDK 的凭据（共享配置、SSO、web identity、实例或任务角色）。

1. 在网关主机上配置 AWS 凭据

任何兼容 AWS SDK 的认证源均可：

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

2. 验证模型是否已发现

openclaw models list

OpenClaw 会自动从凭据链生成 Mantle bearer token。

Tip

当未设置 AWS_BEARER_TOKEN_BEDROCK 时，OpenClaw 会从 AWS 默认凭据链为你生成 bearer token，包括共享凭据/配置 profile、SSO、web identity 以及实例或任务角色。

自动模型发现¶

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

行为	详情
发现缓存	同一区域和 bearer 凭据的结果缓存 1 小时
IAM token 刷新	每 2 小时，按区域缓存

失败的刷新会报告目录访问不可用或被拒绝。目录会保留带有该失败状态的兼容最后可用模型；过期的发现数据不会被视为成功刷新。成功的空响应会清除已发现的成员资格。在失败后，请恢复端点访问并再次刷新。

该插件的公共发现辅助函数保留其 v2026.9.2 建议默认值：失败时可能返回相同凭据的陈旧行，隐式解析对空结果返回 null。编程调用者可以传入 discoveryMode: "strict" 以进行失败传播和成功的空提供方结果。捆绑的目录钩子始终选择该严格模式。

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

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

Note

该 bearer token 与标准 Amazon Bedrock 提供方使用的 AWS_BEARER_TOKEN_BEDROCK 相同。

支持的区域¶

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 行。对于匹配的行，显式的 input 优先；当源行省略 input 时，发现过程可以填充该能力元数据。省略 models 以保留自动 Mantle 目录，或者包含你想要使用的完整 Claude 模型条目。

高级配置¶

推理支持

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

端点不可用

失败的端点请求会报告目录访问不可用或被拒绝。兼容的最后可用模型仍会以该失败状态列出。成功的空响应会清除已发现的成员资格。如果无法解析任何 bearer token，则不会尝试发现，并且会跳过隐式提供方。其他已配置的提供方继续正常工作。

通过 Anthropic Messages 路由使用 Claude

当模型列表由自动发现管理时，OpenClaw 会在一次成功的 /v1/models 查询返回至少一个模型后，追加五个 Claude 模型： 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 接口，并通过同一个经过 bearer 认证的 Anthropic 兼容端点（<mantle-base>/anthropic）进行流式传输，因此 AWS bearer token 不会被当作 Anthropic API key 处理。

Claude Opus 5 公布 1,000,000 token 的上下文窗口、128,000 token 的输出限制、图像输入，以及 $5/$25 的输入/输出定价。自适应 thinking 默认为 high；/think off 会禁用 thinking，而 /think xhigh|max 会使用模型的原生 effort 级别。OpenClaw 会省略调用方选择的采样参数。

Claude Sonnet 5 始终使用自适应 thinking，并默认使用 high effort。/think off 和 /think minimal 会映射到 low，因为 Mantle 路由无法禁用 thinking。OpenClaw 也会省略 Sonnet 5 请求中的自定义 temperature。

Claude Mythos 5 为受限访问。它公布 1,000,000 token 的上下文窗口和 128,000 token 的输出限制，始终使用自适应 thinking，将 /think off 和 /think minimal 映射到 low，并省略调用方选择的采样参数。

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

非空的显式 models.providers["amazon-bedrock-mantle"].models 列表会控制成员资格，并替换完整的已发现目录。匹配的行只有在源行省略了 input 能力时，才能继承已发现的 input 能力。如果你希望使用这些内置 Claude 行，请省略该列表。

与 Amazon Bedrock 提供方的关系

Bedrock Mantle 是与标准 Amazon Bedrock 提供方不同的提供方。Mantle 使用 OpenAI 兼容的 /v1 接口来提供其 OSS 目录，而标准 Bedrock 提供方使用原生 Bedrock Converse API。

当存在时，两个提供方共享同一个 AWS_BEARER_TOKEN_BEDROCK 凭据。

Amazon Bedrock

用于 Anthropic Claude、Titan 和其他模型的原生 Bedrock 提供方。

模型选择

选择提供方、模型引用和故障转移行为。

OAuth 和认证

认证详情和凭据复用规则。

故障排查

常见问题及其解决方法。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw