Providers

Amazon Bedrock Mantle

OpenClaw には、Mantle の OpenAI 互換エンドポイントに接続するバンドル済み Amazon Bedrock Mantle プロバイダーが含まれています。Mantle は、Bedrock インフラストラクチャに支えられた標準の /v1/chat/completions サーフェスを通じて、オープンソースおよびサードパーティモデル(GPT-OSS、Qwen、Kimi、GLM など)をホストします。

プロパティ
プロバイダー ID amazon-bedrock-mantle
API openai-completions(OpenAI 互換)または anthropic-messages(Anthropic Messages ルート)
認証 明示的な AWS_BEARER_TOKEN_BEDROCK または IAM 認証情報チェーンによるベアラートークン生成
既定のリージョン us-east-1AWS_REGION または AWS_DEFAULT_REGION で上書き)

はじめに

希望する認証方式を選び、セットアップ手順に従ってください。

明示的なベアラートークン

最適な用途: Mantle ベアラートークンをすでに持っている環境。

  • Gateway ホストでベアラートークンを設定する

    bash
    export AWS_BEARER_TOKEN_BEDROCK="..."

    必要に応じてリージョンを設定します(既定は us-east-1):

    bash
    export AWS_REGION="us-west-2"
  • Claude Fable 5 のプロバイダーデータ共有にオプトインする

    Claude Fable 5 と Claude Mythos クラスの Bedrock モデルは、呼び出し前に Mantle Data Retention API モード provider_data_share が必要です。このオプトインにより、Bedrock はプロンプトと補完を Anthropic と共有し、信頼性と安全性のレビューのために最大 30 日間保持できます。

    bash
    AWS_REGION="${AWS_REGION:-us-east-1}"curl -X PUT "https://bedrock-mantle.${AWS_REGION}.api.aws/v1/data_retention" \  -H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK" \  -H "Content-Type: application/json" \  -d '{ "mode": "provider_data_share" }'

    その保持モードを受け入れられない場合は、設定で別の Bedrock モデルを使用してください。

  • モデルが検出されることを確認する

    bash
    openclaw models list

    検出されたモデルは amazon-bedrock-mantle プロバイダーの下に表示されます。既定値を上書きしたい場合を除き、追加の設定は不要です。

  • IAM 認証情報

    最適な用途: AWS SDK 互換の認証情報(共有設定、SSO、Web ID、インスタンスロールまたはタスクロール)を使用する場合。

  • Gateway ホストで 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 トークン更新 1 時間ごと

    Mantle Plugin を有効にしたまま、自動検出と IAM ベアラートークン生成を抑制するには、Plugin 所有の検出トグルを無効にします:

    bash
    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.

    手動設定

    自動検出ではなく明示的な設定を使用したい場合:

    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 のサポート

    Reasoning のサポートは、thinkingreasonergpt-oss-120b のようなパターンを含むモデル ID から推論されます。OpenClaw は、検出時に一致するモデルへ reasoning: true を自動的に設定します。

    エンドポイントが利用できない場合

    Mantle エンドポイントが利用できない、またはモデルを返さない場合、そのプロバイダーは黙ってスキップされます。OpenClaw はエラーを出しません。他の設定済みプロバイダーは通常どおり動作し続けます。

    Anthropic Messages ルート経由の Claude Opus 4.7

    Mantle は、同じベアラー認証付きストリーミングパスで Claude モデルを扱う Anthropic Messages ルートも公開します。Claude Opus 4.7(amazon-bedrock-mantle/claude-opus-4.7)は、このルートを通じてプロバイダー所有のストリーミングで呼び出せるため、AWS ベアラートークンは Anthropic API キーのようには扱われません。

    Mantle プロバイダー上で Anthropic Messages モデルを固定すると、OpenClaw はそのモデルに対して openai-completions ではなく anthropic-messages API サーフェスを使用します。認証は引き続き AWS_BEARER_TOKEN_BEDROCK(または発行された IAM ベアラートークン)から取得されます。

    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 プロバイダーとの関係

    Bedrock Mantle は、標準の Amazon Bedrock プロバイダーとは別のプロバイダーです。Mantle は OpenAI 互換の /v1 サーフェスを使用し、標準の Bedrock プロバイダーはネイティブの Bedrock API を使用します。

    両方のプロバイダーは、存在する場合は同じ AWS_BEARER_TOKEN_BEDROCK 認証情報を共有します。

    関連

    Was this useful?
    On this page

    On this page