跳到正文
FunCoding

搜索

搜索文档、文章、Skill 和 MCP

Amazon Bedrock Mantle

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

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

属性值
提供商 IDamazon-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 list

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

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

自动发现模型

设置 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

此持有者令牌与标准 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 条目。省略 models 可保留 自动生成的 Mantle 目录；也可以加入要使用的全部 Claude 模型条目。

高级配置

推理支持

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

端点不可用

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

通过 Anthropic Messages 路由使用 Claude

当模型列表由自动发现管理时，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 条目，请省略该列表。

与 Amazon Bedrock 提供商的关系

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

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

相关内容