Providers

Amazon Bedrock

OpenClaw は pi-ai の Bedrock Converse ストリーミングプロバイダー経由で Amazon Bedrock モデルを使用できます。Bedrock 認証は API キーではなく、AWS SDK デフォルト認証情報チェーンを使用します。

プロパティ	値
プロバイダー	`amazon-bedrock`
API	`bedrock-converse-stream`
認証	AWS 認証情報（環境変数、共有設定、またはインスタンスロール）
リージョン	`AWS_REGION` または `AWS_DEFAULT_REGION`（デフォルト: `us-east-1`）

はじめに

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

アクセスキー / 環境変数

最適な用途: 開発者マシン、CI、または AWS 認証情報を直接管理するホスト。

Gateway ホストで AWS 認証情報を設定する

bash

export AWS_ACCESS_KEY_ID="AKIA..."export AWS_SECRET_ACCESS_KEY="..."export AWS_REGION="us-east-1"# Optional:export AWS_SESSION_TOKEN="..."export AWS_PROFILE="your-profile"# Optional (Bedrock API key/bearer token):export AWS_BEARER_TOKEN_BEDROCK="..."

設定に Bedrock プロバイダーとモデルを追加する

apiKey は不要です。プロバイダーを auth: "aws-sdk" で設定します。

json5

{  models: {    providers: {      "amazon-bedrock": {        baseUrl: "https://bedrock-runtime.us-east-1.amazonaws.com",        api: "bedrock-converse-stream",        auth: "aws-sdk",        models: [          {            id: "us.anthropic.claude-opus-4-6-v1:0",            name: "Claude Opus 4.6 (Bedrock)",            reasoning: true,            input: ["text", "image"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 200000,            maxTokens: 8192,          },        ],      },    },  },  agents: {    defaults: {      model: { primary: "amazon-bedrock/us.anthropic.claude-opus-4-6-v1:0" },    },  },}

モデルが利用可能であることを確認する

bash

openclaw models list

EC2 インスタンスロール（IMDS）

最適な用途: IAM ロールがアタッチされた EC2 インスタンスで、認証にインスタンスメタデータサービスを使用する場合。

検出を明示的に有効化する

IMDS を使用する場合、OpenClaw は環境マーカーだけでは AWS 認証を検出できないため、明示的に有効化する必要があります。

bash

openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1

必要に応じて自動モード用の環境マーカーを追加する

環境マーカーによる自動検出パスも機能させたい場合（たとえば、openclaw status サーフェス用）は、次のように設定します。

bash

export AWS_PROFILE=defaultexport AWS_REGION=us-east-1

偽の API キーは必要ありません。

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

bash

openclaw models list

自動モデル検出

OpenClaw は、ストリーミングとテキスト出力をサポートする Bedrock モデルを自動的に検出できます。検出には bedrock:ListFoundationModels と bedrock:ListInferenceProfiles を使用し、結果はキャッシュされます（デフォルト: 1 時間）。

暗黙のプロバイダーが有効になる仕組み:

plugins.entries.amazon-bedrock.config.discovery.enabled が true の場合、 AWS env マーカーが存在しなくても OpenClaw は検出を試みます。
plugins.entries.amazon-bedrock.config.discovery.enabled が未設定の場合、 OpenClaw は次の AWS 認証マーカーのいずれかを検出したときにのみ、暗黙の Bedrock プロバイダーを自動追加します: AWS_BEARER_TOKEN_BEDROCK、AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY、または AWS_PROFILE。
実際の Bedrock ランタイム認証パスは引き続き AWS SDK のデフォルトチェーンを使用するため、検出でオプトインに enabled: true が必要だった場合でも、共有設定、SSO、IMDS インスタンスロール認証は動作できます。

Discovery config options

設定オプションは plugins.entries.amazon-bedrock.config.discovery 配下にあります:

json5

{  plugins: {    entries: {      "amazon-bedrock": {        config: {          discovery: {            enabled: true,            region: "us-east-1",            providerFilter: ["anthropic", "amazon"],            refreshInterval: 3600,            defaultContextWindow: 32000,            defaultMaxTokens: 4096,          },        },      },    },  },}

オプション	デフォルト	説明
`enabled`	auto	auto モードでは、OpenClaw はサポート対象の AWS env マーカーを検出した場合にのみ、暗黙の Bedrock プロバイダーを有効にします。検出を強制するには `true` を設定します。
`region`	`AWS_REGION` / `AWS_DEFAULT_REGION` / `us-east-1`	検出 API 呼び出しに使用する AWS リージョン。
`providerFilter`	(すべて)	Bedrock プロバイダー名に一致します（例: `anthropic`、`amazon`）。
`refreshInterval`	`3600`	キャッシュ期間（秒）。キャッシュを無効にするには `0` に設定します。
`defaultContextWindow`	`32000`	検出されたモデルに使用するコンテキストウィンドウ（モデルの制限を把握している場合は上書きしてください）。
`defaultMaxTokens`	`4096`	検出されたモデルに使用する最大出力トークン数（モデルの制限を把握している場合は上書きしてください）。

クイック設定（AWS パス）

この手順では、IAM ロールを作成し、Bedrock 権限をアタッチし、インスタンスプロファイルを関連付け、EC2 ホストで OpenClaw の検出を有効にします。

bash

# 1. Create IAM role and instance profileaws iam create-role --role-name EC2-Bedrock-Access \  --assume-role-policy-document '{    "Version": "2012-10-17",    "Statement": [{      "Effect": "Allow",      "Principal": {"Service": "ec2.amazonaws.com"},      "Action": "sts:AssumeRole"    }]  }' aws iam attach-role-policy --role-name EC2-Bedrock-Access \  --policy-arn arn:aws:iam::aws:policy/AmazonBedrockFullAccess aws iam create-instance-profile --instance-profile-name EC2-Bedrock-Accessaws iam add-role-to-instance-profile \  --instance-profile-name EC2-Bedrock-Access \  --role-name EC2-Bedrock-Access # 2. Attach to your EC2 instanceaws ec2 associate-iam-instance-profile \  --instance-id i-xxxxx \  --iam-instance-profile Name=EC2-Bedrock-Access # 3. On the EC2 instance, enable discovery explicitlyopenclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1 # 4. Optional: add an env marker if you want auto mode without explicit enableecho 'export AWS_PROFILE=default' >> ~/.bashrcecho 'export AWS_REGION=us-east-1' >> ~/.bashrcsource ~/.bashrc # 5. Verify models are discoveredopenclaw models list

高度な設定

推論プロファイル

OpenClaw は、基盤モデルと並んで リージョン推論プロファイルとグローバル推論プロファイル を検出します。プロファイルが既知の基盤モデルに対応する場合、そのプロファイルはそのモデルの機能（コンテキストウィンドウ、最大トークン数、推論、ビジョン）を継承し、正しい Bedrock リクエストリージョンが自動的に注入されます。つまり、クロスリージョンの Claude プロファイルは、手動のプロバイダー上書きなしで動作します。

推論プロファイル ID は us.anthropic.claude-opus-4-6-v1:0（リージョン）または anthropic.claude-opus-4-6-v1:0（グローバル）のような形式です。基盤となるモデルがすでに検出結果に含まれている場合、プロファイルはその完全な機能セットを継承します。それ以外の場合は安全なデフォルトが適用されます。

追加設定は不要です。検出が有効で、IAM プリンシパルに bedrock:ListInferenceProfiles がある限り、プロファイルは openclaw models list で基盤モデルと並んで表示されます。

サービスティア

一部の Bedrock モデルは、コストまたはレイテンシーを最適化するための service_tier パラメーターをサポートしています。次のティアを利用できます。

ティア	説明
`default`	標準の Bedrock ティア
`flex`	より長いレイテンシーを許容できるワークロード向けの割引処理
`priority`	レイテンシー重視のワークロード向けの優先処理
`reserved`	定常的なワークロード向けの予約済みキャパシティ

Bedrock モデルリクエストでは、agents.defaults.params 経由で serviceTier（または service_tier）を設定できます。または、agents.defaults.models["<model-key>"].params でモデルごとに設定できます。

json5

{  agents: {    defaults: {      params: {        serviceTier: "flex", // applies to all models      },      models: {        "amazon-bedrock/mistral.mistral-large-3-675b-instruct": {          params: {            serviceTier: "priority", // per-model override          },        },      },    },  },}

有効な値は default、flex、priority、reserved です。すべてのモデルがすべてのティアをサポートしているわけではありません。サポートされていないティアがリクエストされた場合、Bedrock は検証エラーを返します。注: エラーメッセージはやや誤解を招きます。サポートされていないサービスティアを示すのではなく、「The provided model identifier is invalid」と表示されることがあります。このエラーが表示された場合は、そのモデルがリクエストしたティアをサポートしているか確認してください。

Claude Opus 4.7 の temperature

Bedrock は Claude Opus 4.7 の temperature パラメーターを拒否します。OpenClaw は、任意の Opus 4.7 Bedrock ref について temperature を自動的に省略します。これには、基盤モデル ID、名前付き推論プロファイル、bedrock:GetInferenceProfile 経由で基盤となるモデルが Opus 4.7 に解決されるアプリケーション推論プロファイル、および任意のリージョンプレフィックス（us.、eu.、ap.、apac.、au.、jp.、global.）を持つドット区切りの opus-4.7 バリアントが含まれます。設定ノブは不要で、この省略はリクエストオプションオブジェクトと inferenceConfig ペイロードフィールドの両方に適用されます。

ガードレール

amazon-bedrock Plugin 設定に guardrail オブジェクトを追加すると、すべての Bedrock モデル呼び出しに Amazon Bedrock Guardrails を適用できます。ガードレールにより、コンテンツフィルタリング、トピック拒否、単語フィルター、機密情報フィルター、コンテキストに基づくグラウンディングチェックを適用できます。

json5

{  plugins: {    entries: {      "amazon-bedrock": {        config: {          guardrail: {            guardrailIdentifier: "abc123", // guardrail ID or full ARN            guardrailVersion: "1", // version number or "DRAFT"            streamProcessingMode: "sync", // optional: "sync" or "async"            trace: "enabled", // optional: "enabled", "disabled", or "enabled_full"          },        },      },    },  },}

オプション	必須	説明
`guardrailIdentifier`	はい	Guardrail ID（例: `abc123`）または完全な ARN（例: `arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123`）。
`guardrailVersion`	はい	公開済みバージョン番号、または作業中のドラフトを示す `"DRAFT"`。
`streamProcessingMode`	いいえ	ストリーミング中のガードレール評価に使う `"sync"` または `"async"`。省略すると、Bedrock はデフォルトを使用します。
`trace`	いいえ	デバッグ用の `"enabled"` または `"enabled_full"`。本番環境では省略するか `"disabled"` に設定します。

メモリ検索用の埋め込み

Bedrock はメモリ検索の埋め込みプロバイダーとしても使用できます。これは推論プロバイダーとは別に設定します。agents.defaults.memorySearch.provider を "bedrock" に設定してください。

json5

{  agents: {    defaults: {      memorySearch: {        provider: "bedrock",        model: "amazon.titan-embed-text-v2:0", // default      },    },  },}

Bedrock の埋め込みは、推論と同じ AWS SDK 認証情報チェーンを使用します（インスタンスロール、SSO、アクセスキー、共有設定、Web アイデンティティ）。API キーは不要です。provider が "auto" の場合、その認証情報チェーンが正常に解決されると Bedrock が自動検出されます。

サポートされる埋め込みモデルには、Amazon Titan Embed（v1、v2）、Amazon Nova Embed、Cohere Embed（v3、v4）、TwelveLabs Marengo が含まれます。完全なモデル一覧と次元オプションについては、メモリ設定リファレンス -- Bedrock を参照してください。

注記と注意点

Bedrock では、AWS アカウント/リージョンで モデルアクセス が有効になっている必要があります。
自動検出には bedrock:ListFoundationModels と bedrock:ListInferenceProfiles 権限が必要です。
自動モードに依存する場合は、Gateway ホストでサポートされている AWS 認証環境マーカーのいずれかを設定してください。環境マーカーなしで IMDS/共有設定認証を使用したい場合は、 plugins.entries.amazon-bedrock.config.discovery.enabled: true を設定してください。
OpenClaw は認証情報ソースを次の順序で表示します: AWS_BEARER_TOKEN_BEDROCK、次に AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY、次に AWS_PROFILE、次にデフォルトの AWS SDK チェーン。
推論サポートはモデルによって異なります。現在の機能については Bedrock モデルカードを確認してください。
管理キーのフローを使いたい場合は、Bedrock の前段に OpenAI 互換プロキシを配置し、代わりに OpenAI プロバイダーとして設定することもできます。