Appearance
想在 OpenClaw 中使用 Amazon Bedrock Mantle 托管开源模型(GPT-OSS、Qwen、Kimi、GLM)?设置环境变量 AWS_BEARER_TOKEN_BEDROCK 或通过 AWS IAM 凭证链自动生成 Bearer Token,然后运行 openclaw models list 验证模型是否被自动发现。默认区域 us-east-1,可设置 AWS_REGION 覆盖。如果不希望自动发现,可运行 openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false 关闭。
OpenClaw 配置 Amazon Bedrock Mantle 接入指南
OpenClaw 内置 Amazon Bedrock Mantle Provider,用于对接 Mantle 的 OpenAI 兼容端点。Mantle 在 Bedrock 基础设施上托管开源及第三方模型(GPT-OSS、Qwen、Kimi、GLM 等),提供标准 /v1/chat/completions 接口。
| 属性 | 值 |
|---|---|
| Provider ID | amazon-bedrock-mantle |
| API | openai-completions(OpenAI 兼容)或 anthropic-messages(Anthropic Messages 路由) |
| 认证 | 显式 AWS_BEARER_TOKEN_BEDROCK 或 IAM 凭证链自动生成 Bearer Token |
| 默认区域 | us-east-1(通过 AWS_REGION 或 AWS_DEFAULT_REGION 覆盖) |
接入步骤
选择你的认证方式,按步骤操作。
显式 Bearer Token
**适用于:** 已有 Mantle Bearer Token 的环境。
在网关主机上设置 Bearer Token
```bash
export AWS_BEARER_TOKEN_BEDROCK="..."
```
可选设置区域(默认 `us-east-1`):
```bash
export AWS_REGION="us-west-2"
```
验证模型被发现
```bash
openclaw models list
```
发现的模型会显示在 `amazon-bedrock-mantle` Provider 下。除非你需要覆盖默认配置,否则无需额外配置。
IAM 凭证
**适用于:** 使用 AWS SDK 兼容凭证(共享配置、SSO、Web Identity、实例或任务角色)。
在网关主机上配置 AWS 凭证
任何 AWS SDK 兼容的认证源均可:
```bash
export AWS_PROFILE="default"
export AWS_REGION="us-west-2"
```
验证模型被发现
```bash
openclaw models list
```
OpenClaw 会自动从凭证链生成 Mantle Bearer Token。
TIP
当 `AWS_BEARER_TOKEN_BEDROCK` 未设置时,OpenClaw 会从 AWS 默认凭证链为你生成 Bearer Token,包括共享凭证配置文件、SSO、Web Identity 以及实例或任务角色。
自动模型发现
当设置了 AWS_BEARER_TOKEN_BEDROCK 时,OpenClaw 直接使用该值。否则,OpenClaw 会尝试从 AWS 默认凭证链生成 Mantle Bearer Token,然后通过查询该区域的 /v1/models 接口发现可用模型。
| 行为 | 详情 |
|---|---|
| 发现结果缓存 | 结果缓存 1 小时 |
| IAM 派生 Token 刷新 | 每小时刷新一次 |
如果希望保持 Mantle 插件启用但关闭自动发现和 IAM Bearer Token 生成,可以关闭插件自带的发现开关:
bash
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled falseINFO
这个 Bearer Token 与标准 Amazon Bedrock Provider 使用的 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.
手动配置
如果你希望使用显式配置而非自动发现:
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,
},
],
},
},
},
}高级配置
推理能力支持
推理能力(reasoning)通过模型 ID 自动推断,ID 中包含 `thinking`、`reasoner` 或 `gpt-oss-120b` 等模式时,OpenClaw 会在发现时自动设置 `reasoning: true`。
端点不可用
如果 Mantle 端点不可用或未返回任何模型,该 Provider 会被静默跳过。OpenClaw 不会报错,其他已配置的 Provider 正常工作。
通过 Anthropic Messages 路由使用 Claude Opus 4.7
Mantle 还暴露了一个 Anthropic Messages 路由,通过相同的 Bearer 认证流式承载 Claude 模型。Claude Opus 4.7(`amazon-bedrock-mantle/claude-opus-4.7`)可通过此路由调用,使用 Provider 自有的流式处理,因此 AWS Bearer Token 不会被当作 Anthropic API 密钥对待。
当你在 Mantle Provider 上固定使用 Anthropic Messages 模型时,OpenClaw 会为该模型使用 `anthropic-messages` API 接口而非 `openai-completions`。认证仍然来自 `AWS_BEARER_TOKEN_BEDROCK`(或生成的 IAM Bearer Token)。
```json5
{
models: {
providers: {
"amazon-bedrock-mantle": {
models: [
{
id: "claude-opus-4.7",
name: "Claude Opus 4.7",
api: "anthropic-messages",
reasoning: true,
input: ["text", "image"],
contextWindow: 1000000,
maxTokens: 32000,
},
],
},
},
},
}
```
与 Amazon Bedrock Provider 的关系
Bedrock Mantle 是标准的 [Amazon Bedrock](/ai/ai-tools/openclaw/providers/bedrock) Provider 之外的一个独立 Provider。Mantle 使用 OpenAI 兼容的 `/v1` 接口,而标准的 Bedrock Provider 使用原生 Bedrock API。
两者在设置 `AWS_BEARER_TOKEN_BEDROCK` 时共享同一个凭证变量。
相关文档
Amazon Bedrock
Native Bedrock provider for Anthropic Claude, Titan, and other models.
模型选择
选择 Provider、模型引用和故障转移行为。
OAuth 与认证
认证详情和凭证复用规则。
故障排除
常见问题及解决方法。
常见问题
如何关闭 Amazon Bedrock Mantle 的自动模型发现?
运行 openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false 即可禁用。此后需要手动在配置中指定模型。
AWS_BEARER_TOKEN_BEDROCK 不设置可以吗?
可以。如果未设置,OpenClaw 会从 AWS 默认凭证链自动生成 Bearer Token,前提是主机的凭证链可用(如 AWS_PROFILE、SSO、实例角色等)。生成的 Token 每小时刷新一次。
支持哪些 AWS 区域?
支持 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。默认 us-east-1,可通过 AWS_REGION 环境变量修改。