Skip to content

Amazon Bedrock Mantle

OpenClaw 包含一個內建的 Amazon Bedrock Mantle 提供者,可連線至 Mantle OpenAI 相容端點。Mantle 透過由 Bedrock 基礎設施支援的標準 /v1/chat/completions 介面,託管開放原始碼和 第三方模型 (GPT-OSS、Qwen、Kimi、GLM 和類似模型)。

屬性
提供者 IDamazon-bedrock-mantle
APIopenai-completions (OpenAI 相容) 或 anthropic-messages (Anthropic Messages 路由)
驗證明確的 AWS_BEARER_TOKEN_BEDROCK 或 IAM 憑證鏈 bearer-token 產生
預設區域us-east-1 (使用 AWS_REGIONAWS_DEFAULT_REGION 覆蓋)

選擇您偏好的驗證方法,並依照設定步驟操作。

最適用於: 您已經擁有 Mantle bearer token 的環境。

  1. 在閘道主機上設定 bearer token

    Terminal window
    export AWS_BEARER_TOKEN_BEDROCK="..."

    選擇性設定區域 (預設為 us-east-1):

    Terminal window
    export AWS_REGION="us-west-2"
  2. 驗證模型是否已探索到

    ```bash
    openclaw models list
    ```
    探索到的模型會出現在 `amazon-bedrock-mantle` 提供者下。除非您想要覆蓋預設值,否則

    不需要額外的設定。

當已設定 AWS_BEARER_TOKEN_BEDROCK 時,OpenClaw 會直接使用它。否則, OpenClaw 會嘗試從 AWS 預設憑證鏈結產生 Mantle 持有者權杖。然後透過查詢 該區域的 /v1/models 端點來探索可用的 Mantle 模型。

行為詳細資訊
探索快取結果快取 1 小時
IAM 權杖重新整理每小時

若要讓 Mantle 外掛程式保持啟用,但抑制自動探索和 IAM 持有者權杖產生,請停用外掛程式擁有的探索切換開關:

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

us-east-1us-east-2us-west-2ap-northeast-1ap-south-1ap-southeast-3eu-central-1eu-west-1eu-west-2eu-south-1eu-north-1sa-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 路由,透過相同的持有人驗證串流路徑傳輸 Claude 模型。Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) 可透過此路由呼叫,並使用提供者擁有的串流,因此 AWS 持有人權杖不會被視為 Anthropic API 金鑰。

當您在 Mantle 提供者上釘選 Anthropic Messages 模型時,OpenClaw 會使用 anthropic-messages API 介面,而不是該模型的 openai-completions。驗證仍然來自 AWS_BEARER_TOKEN_BEDROCK (或鑄造的 IAM 持有人權杖)。

{
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 憑證。

Amazon Bedrock

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

模型選擇

選擇提供者、模型參照和容錯移轉行為。

OAuth 與驗證

驗證詳細資訊和憑證重複使用規則。

疑難排解

常見問題與解決方法。