OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Amazon Bedrock Mantle

OpenClaw には、Mantle の OpenAI 互換エンドポイントに接続する Amazon Bedrock 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_REGION または AWS_DEFAULT_REGION で上書き）

はじめに

希望する認証方法を選択し、セットアップ手順に従います。

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

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

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

    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、ウェブアイデンティティ、インスタンスロールまたはタスクロール）の使用。

  • 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 トークンの更新 リージョンごとにキャッシュされ、2 時間ごとに更新されます

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

    明示的に指定した空でない models リストが優先され、以下の Claude 行を含む、検出された すべての行を置き換えます。Mantle の自動カタログを維持するには models を省略するか、 使用する Claude モデルの完全なエントリを含めてください。

    高度な設定

    推論のサポート

    推論のサポートは、thinking、reasoner、reasoning、deepseek.r、gpt-oss-120b、 gpt-oss-safeguard-120b などのパターンを含むモデル ID から推測されます。OpenClaw は、 検出時に一致するモデルへ reasoning: true を自動的に設定します。

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

    Mantle エンドポイントを利用できない場合、モデルが返されない場合、またはベアラートークンの 解決に失敗した場合、検出は空の結果を返し、暗黙的な プロバイダーはスキップされます。OpenClaw はエラーを発生させず、設定済みの他のプロバイダーは 通常どおり動作を続けます。

    Anthropic Messages ルート経由の Claude

    自動検出がモデルリストを管理している場合、OpenClaw は、/v1/models が返す内容に関係なく、 検索に成功した後で 5 つの Claude モデルを追加します。 amazon-bedrock-mantle/anthropic.claude-opus-5（Claude Opus 5）、 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 Preview）です。これらは anthropic-messages API サーフェスを使用し、 ベアラー認証された同じ Anthropic 互換エンドポイント （<mantle-base>/anthropic）を通じてストリーミングするため、AWS ベアラートークンは Anthropic API キーとして扱われません。

    Claude Opus 5 は、1,000,000 トークンのコンテキストウィンドウ、128,000 トークンの 出力上限、画像入力、および $5/$25 の入出力料金を公開しています。適応型 思考のデフォルトは high です。/think off は思考を無効にし、 /think xhigh|max はモデル固有の労力レベルを使用します。OpenClaw は、 呼び出し元が選択したサンプリングパラメーターを省略します。

    Claude Sonnet 5 は常に適応型思考を使用し、デフォルトの労力は high です。Mantle ルートでは思考を無効にできないため、/think off と /think minimal は low にマッピングされます。OpenClaw は、Sonnet 5 リクエストの カスタム temperature も省略します。

    Claude Mythos 5 はアクセスが制限されています。1,000,000 トークンのコンテキスト ウィンドウと 128,000 トークンの出力上限を公開し、常に適応型思考を使用し、 /think off と /think minimal を low にマッピングし、呼び出し元が選択した サンプリングパラメーターを省略します。

    Claude Mythos Preview は常に推論をリクエストし、/think レベルが設定されていない場合、 デフォルトの労力として high を使用します（xhigh/max は high に引き下げられ、minimal は low に引き上げられます）。Mantle 上の Opus 4.7 は、 モデルが提供する推論なしでストリーミングし、このルートでは Opus 4.7 がサンプリングの上書きを 受け付けないため、OpenClaw はその temperature パラメーターを省略します。一方、Mythos Preview は通常どおり 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 認証情報が存在する場合、両方のプロバイダーがそれを共有します。

    関連項目

    Amazon Bedrock

    Anthropic Claude、Titan、およびその他のモデル向けのネイティブ Bedrock プロバイダー。
    モデルの選択

    プロバイダー、モデル参照、フェイルオーバー動作の選択。
    OAuth と認証

    認証の詳細と認証情報の再利用ルール。
    トラブルシューティング

    一般的な問題とその解決方法。
    Was this useful?
    On this page

    On this page