Providers

Amazon Bedrock Mantle

OpenClaw 內建隨附的 Amazon Bedrock Mantle 提供者,可連線至 與 OpenAI 相容的 Mantle 端點。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_REGIONAWS_DEFAULT_REGION 覆寫)

開始使用

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

明確設定持有人權杖

最適合: 已有 Mantle 持有人權杖的環境。

  • 在閘道主機上設定持有人權杖

    bash
    export AWS_BEARER_TOKEN_BEDROCK="..."

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

    bash
    export AWS_REGION="us-west-2"
  • 確認已探索到模型

    bash
    openclaw models list

    探索到的模型會顯示在 amazon-bedrock-mantle 提供者下。除非要覆寫預設值, 否則不需要額外設定。

  • IAM 憑證

    最適合: 使用與 AWS SDK 相容的憑證(共用設定、SSO、Web 身分、執行個體或任務角色)。

  • 在閘道主機上設定 AWS 憑證

    任何與 AWS SDK 相容的驗證來源皆可使用:

    bash
    export AWS_PROFILE="default"export AWS_REGION="us-west-2"
  • 確認已探索到模型

    bash
    openclaw models list

    OpenClaw 會自動從憑證鏈產生 Mantle 持有人權杖。

  • 自動模型探索

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

    行為 詳細資訊
    探索快取 每個區域的結果會快取 1 小時;擷取失敗時會傳回最後一次快取的結果
    IAM 權杖重新整理 每 2 小時一次,按區域快取

    若要讓 Mantle 外掛保持啟用,但停用自動探索與 IAM 持有人權杖產生,請停用此外掛所擁有的探索切換設定:

    bash
    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

    手動設定

    若偏好使用明確設定而非自動探索:

    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,          },        ],      },    },  },}

    明確指定且非空的 models 清單具有最高決定權,並會取代所有 探索到的項目,包括下方的 Claude 項目。省略 models 即可保留 自動 Mantle 目錄;或者加入你想使用的完整 Claude 模型項目。

    進階設定

    推理支援

    推理支援會根據模型 ID 是否包含 thinkingreasonerreasoningdeepseek.rgpt-oss-120bgpt-oss-safeguard-120b 等模式來推斷。在探索期間,OpenClaw 會自動為 符合的模型設定 reasoning: true

    端點無法使用

    如果 Mantle 端點無法使用、未傳回任何模型,或持有人權杖 解析失敗,探索會傳回空結果並略過隱含提供者。OpenClaw 不會報錯; 其他已設定的提供者仍會正常運作。

    透過 Anthropic Messages 路由使用 Claude

    當模型清單由自動探索管理時,成功查詢後,OpenClaw 會附加四個 Claude 模型,無論 /v1/models 傳回什麼: 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 預覽版)。它們使用 anthropic-messages API 介面,並透過 相同、以持有人權杖驗證且與 Anthropic 相容的端點 (<mantle-base>/anthropic)進行串流,因此 AWS 持有人權杖不會被視為 Anthropic API 金鑰。

    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 預覽版一律要求推理;未設定 /think 層級時,預設為 high 強度(將 xhighmax 下調至 high,並將 minimal 上調至 low)。Mantle 上的 Opus 4.7 串流不包含 模型提供的推理內容;由於 Opus 4.7 在此路由上不接受取樣覆寫,OpenClaw 會省略其 temperature 參數;Mythos 預覽版則正常接受 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 存在時,兩個提供者會共用相同的憑證。

    相關內容

    Was this useful?
    On this page

    On this page