快速开始
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 模型条目。
高级配置
推理支持
是否支持推理根据模型 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 凭证,两个提供商会共享该凭证。