Providers
Amazon Bedrock Mantle
OpenClaw 包含一個內建的 Amazon Bedrock Mantle 提供者,可連接到
Mantle 的 OpenAI 相容端點。Mantle 透過標準
/v1/chat/completions 介面提供由 Bedrock 基礎架構支援的開源與
第三方模型(GPT-OSS、Qwen、Kimi、GLM 及類似模型)。
| 屬性 | 值 |
|---|---|
| 提供者 ID | amazon-bedrock-mantle |
| API | openai-completions(OpenAI 相容)或 anthropic-messages(Anthropic Messages 路由) |
| 驗證 | 明確的 AWS_BEARER_TOKEN_BEDROCK 或 IAM 憑證鏈 Bearer 權杖產生 |
| 預設區域 | us-east-1(使用 AWS_REGION 或 AWS_DEFAULT_REGION 覆寫) |
開始使用
選擇偏好的驗證方法並依照設定步驟操作。
明確的 Bearer 權杖
最適合: 已有 Mantle Bearer 權杖的環境。
在 Gateway 主機上設定 Bearer 權杖
export AWS_BEARER_TOKEN_BEDROCK="..."
也可以設定區域(預設為 us-east-1):
export AWS_REGION="us-west-2"
驗證已探索到模型
openclaw models list
已探索到的模型會出現在 amazon-bedrock-mantle 提供者底下。除非
你想覆寫預設值,否則不需要其他設定。
IAM 憑證
最適合: 使用 AWS SDK 相容憑證(共享設定、SSO、網頁身分、執行個體或任務角色)。
在 Gateway 主機上設定 AWS 憑證
任何 AWS SDK 相容的驗證來源都可使用:
export AWS_PROFILE="default"
export AWS_REGION="us-west-2"
驗證已探索到模型
openclaw models list
OpenClaw 會自動從憑證鏈產生 Mantle Bearer 權杖。
自動模型探索
設定 AWS_BEARER_TOKEN_BEDROCK 時,OpenClaw 會直接使用它。否則,
OpenClaw 會嘗試從 AWS 預設憑證鏈產生 Mantle Bearer 權杖。接著會透過查詢該
區域的 /v1/models 端點來探索可用的 Mantle 模型。
| 行為 | 詳細資料 |
|---|---|
| 探索快取 | 結果快取 1 小時 |
| IAM 權杖重新整理 | 每小時 |
支援的區域
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,
},
],
},
},
},
}
進階設定
推理支援
推理支援會從包含類似
thinking、reasoner 或 gpt-oss-120b 模式的模型 ID 推斷。OpenClaw 會在探索期間,為相符模型自動設定 reasoning: true。
端點無法使用
如果 Mantle 端點無法使用或沒有傳回模型,該提供者會被靜默略過。OpenClaw 不會報錯;其他已設定的提供者會繼續正常運作。
透過 Anthropic Messages 路由使用 Claude Opus 4.7
Mantle 也提供 Anthropic Messages 路由,透過相同的 Bearer 驗證串流路徑承載 Claude 模型。Claude Opus 4.7(amazon-bedrock-mantle/claude-opus-4.7)可透過此路由以提供者擁有的串流呼叫,因此 AWS Bearer 權杖不會被視為 Anthropic API 金鑰。
當你在 Mantle 提供者上固定使用 Anthropic Messages 模型時,OpenClaw 會針對該模型使用 anthropic-messages API 介面,而不是 openai-completions。驗證仍來自 AWS_BEARER_TOKEN_BEDROCK(或鑄造的 IAM Bearer 權杖)。
{
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 提供者的關係
Bedrock Mantle 是不同於標準
Amazon Bedrock 提供者的獨立提供者。Mantle 使用
OpenAI 相容的 /v1 介面,而標準 Bedrock 提供者使用
原生 Bedrock API。
兩個提供者在存在時會共享相同的 AWS_BEARER_TOKEN_BEDROCK 憑證。