メインコンテンツへスキップ
OpenClaw は、その Bedrock Converse ストリーミングプロバイダーを介して Amazon Bedrock モデルを使用できます。Bedrock 認証は API キーではなく、AWS SDK のデフォルト認証情報チェーンを使用します。
プロパティ値
プロバイダーamazon-bedrock
APIbedrock-converse-stream
認証AWS 認証情報（環境変数、共有設定、またはインスタンスロール）
リージョンAWS_REGION または AWS_DEFAULT_REGION（デフォルト: us-east-1）

​
はじめに

好みの認証方法を選び、セットアップ手順に従います。
最適な用途: 開発者マシン、CI、または AWS 認証情報を直接管理するホスト。
1

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

export AWS_ACCESS_KEY_ID="EXAMPLE_AWS_ACCESS_KEY_ID"
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="..."
2

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

apiKey は不要です。プロバイダーを auth: "aws-sdk" で設定します。
{
  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" },
    },
  },
}
3

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

openclaw models list
環境マーカー認証（AWS_ACCESS_KEY_ID、AWS_PROFILE、または AWS_BEARER_TOKEN_BEDROCK）では、OpenClaw は追加設定なしで、モデル検出用の暗黙的な Bedrock プロバイダーを自動的に有効化します。

​
モデルの自動検出

OpenClaw は、ストリーミングとテキスト出力をサポートする Bedrock モデルを自動的に検出できます。検出には bedrock:ListFoundationModels と bedrock:ListInferenceProfiles が使用され、結果はキャッシュされます（デフォルト: 1 時間）。 暗黙的なプロバイダーが有効化される仕組み:
  • plugins.entries.amazon-bedrock.config.discovery.enabled が true の場合、AWS 環境マーカーが存在しなくても 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 インスタンスロール認証は動作できます。
明示的な models.providers["amazon-bedrock"] エントリでは、OpenClaw は完全なランタイム認証読み込みを強制せずに、AWS_BEARER_TOKEN_BEDROCK などの AWS 環境マーカーから Bedrock 環境マーカー認証を早期に解決できます。実際のモデル呼び出し認証パスは引き続き AWS SDK のデフォルトチェーンを使用します。
設定オプションは plugins.entries.amazon-bedrock.config.discovery 配下にあります。
{
  plugins: {
    entries: {
      "amazon-bedrock": {
        config: {
          discovery: {
            enabled: true,
            region: "us-east-1",
            providerFilter: ["anthropic", "amazon"],
            refreshInterval: 3600,
            defaultContextWindow: 32000,
            defaultMaxTokens: 4096,
          },
        },
      },
    },
  },
}
オプションデフォルト説明
enabledauto自動モードでは、OpenClaw はサポートされる AWS 環境マーカーを確認したときにのみ、暗黙的な Bedrock プロバイダーを有効化します。検出を強制するには true を設定します。
regionAWS_REGION / AWS_DEFAULT_REGION / us-east-1検出 API 呼び出しに使用される AWS リージョン。
providerFilter（すべて）Bedrock プロバイダー名に一致します（例: anthropic、amazon）。
refreshInterval3600キャッシュ期間（秒）。キャッシュを無効にするには 0 を設定します。
defaultContextWindow32000既知のトークン制限がない検出済みモデルに使用されるコンテキストウィンドウ（モデルの制限を把握している場合は上書きしてください）。
defaultMaxTokens4096既知のトークン制限がない検出済みモデルに使用される最大出力トークン数（モデルの制限を把握している場合は上書きしてください）。
Bedrock の ListFoundationModels および GetFoundationModel API は、トークン制限のメタデータを返さず、モデル ID、名前、モダリティ、ライフサイクルステータスのみを返します。OpenClaw は、人気の Bedrock モデル（Claude、Nova、Llama、Mistral、DeepSeek など）の既知のコンテキストウィンドウと出力制限のルックアップテーブルを同梱しているため、それらのモデルではセッション管理、Compaction しきい値、コンテキストオーバーフロー検出が正しく動作します。テーブルにない検出済みモデルは、defaultContextWindow と defaultMaxTokens にフォールバックします。使用しているモデルに正確な制限がない場合は、明示的な models.providers["amazon-bedrock"].models エントリで上書きしてください。

​
クイックセットアップ（AWS パス）

この手順では、IAM ロールを作成し、Bedrock 権限をアタッチし、インスタンスプロファイルを関連付け、EC2 ホスト上で OpenClaw の検出を有効化します。 
# 1. Create IAM role and instance profile
aws 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-Access
aws iam add-role-to-instance-profile \
  --instance-profile-name EC2-Bedrock-Access \
  --role-name EC2-Bedrock-Access

# 2. Attach to your EC2 instance
aws ec2 associate-iam-instance-profile \
  --instance-id i-xxxxx \
  --iam-instance-profile Name=EC2-Bedrock-Access

# 3. On the EC2 instance, enable discovery explicitly
openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled true
openclaw 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 enable
echo 'export AWS_PROFILE=default' >> ~/.bashrc
echo 'export AWS_REGION=us-east-1' >> ~/.bashrc
source ~/.bashrc

# 5. Verify models are discovered
openclaw models list

​
高度な設定

OpenClaw は、基盤モデルと並行してリージョン推論プロファイルとグローバル推論プロファイルを検出します。プロファイルが既知の基盤モデルにマッピングされる場合、プロファイルはそのモデルの機能（コンテキストウィンドウ、最大トークン数、推論、ビジョン）を継承し、正しい Bedrock リクエストリージョンが自動的に注入されます。つまり、クロスリージョン Claude プロファイルは、手動のプロバイダー上書きなしで動作します。グローバルなクロスリージョンプロファイル（global.*）は、一般的により優れた容量と自動フェイルオーバーを提供するため、openclaw models list では先頭に表示されます。推論プロファイル 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 でモデルごとに設定します。
{
  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 です。Claude Fable 5 は default ティアのみをサポートします。OpenClaw は、そのモデルに対して要求された flex、priority、reserved を警告して無視します。他の モデルでは、すべてのモデルがすべてのティアをサポートするわけではありません。サポートされていないティアは Bedrock の検証エラーを返し、エラーメッセージが 誤解を招く場合があります（たとえば、問題としてティア名を示すのではなく “The provided model identifier is invalid” と表示されるなど）。このエラーが表示された場合は、 そのモデルが要求されたティアをサポートしているか確認してください。
Bedrock は Claude Opus 4.7 と Opus 4.8 の temperature パラメーターを拒否します。OpenClaw は、一致する任意の Bedrock ref について temperature を自動的に省略します。これには、基盤モデル ID、名前付き推論プロファイル、基盤モデルが bedrock:GetInferenceProfile によって Opus 4.7/4.8 に解決されるアプリケーション 推論プロファイル、および任意のリージョンプレフィックス（us.、eu.、ap.、apac.、au.、jp.、 global.）付きのドット区切り opus-4.7/opus-4.8 バリアントが含まれます。 設定ノブは不要であり、この省略はリクエストオプションオブジェクトと inferenceConfig ペイロードフィールドの両方に適用されます。
us-east-1 では amazon-bedrock/anthropic.claude-fable-5 を使用するか、 us.anthropic.claude-fable-5 などの リージョン推論 ID を使用します。 OpenClaw は Fable の 1M コンテキストウィンドウ、128K 出力制限、常時有効の アダプティブシンキング、およびサポートされる effort マッピングを適用します。/think off と /think minimal は low にマップされます。temperature と強制ツール選択コントロールは Opus 4.7/4.8 ルートと同様に省略されます。ストリーミング出力は、Bedrock が終端ステータスを返すまで 保留されるため、ストリーム途中の拒否によって部分的なテキストが 公開されることはありません。AWS は、Fable を利用可能にする前に明示的な provider_data_share データ保持のオプトインを 要求します。プロンプトと補完は Anthropic と共有され、 信頼と安全のため最大 30 日間保持されます。モデルを有効にする前に、 Bedrock データ保持 を確認して設定してください。
amazon-bedrock Plugin 設定に guardrail オブジェクトを追加することで、 すべての Bedrock モデル呼び出しに Amazon Bedrock Guardrails を適用できます。Guardrails により、コンテンツフィルタリング、 トピック拒否、単語フィルター、機密情報フィルター、コンテキストに基づく グラウンディングチェックを適用できます。
{
  plugins: {
    entries: {
      "amazon-bedrock": {
        config: {
          guardrail: {
            guardrailIdentifier: "abc123", // guardrail ID または完全な ARN
            guardrailVersion: "1", // バージョン番号または "DRAFT"
            streamProcessingMode: "sync", // 任意: "sync" または "async"
            trace: "enabled", // 任意: "enabled"、"disabled"、または "enabled_full"
          },
        },
      },
    },
  },
}
guardrailIdentifier と guardrailVersion は必須です。
オプション説明
guardrailIdentifierGuardrail ID（例: abc123）または完全な ARN（例: arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123）。
guardrailVersion公開済みバージョン番号、または作業中のドラフトを表す "DRAFT"。
streamProcessingModeストリーミング中の guardrail 評価に使用する "sync" または "async"。省略した場合、Bedrock はデフォルトを使用します。
traceデバッグ用の "enabled" または "enabled_full"。本番環境では省略するか "disabled" に設定します。
Gateway で使用される IAM プリンシパルには、標準の呼び出し権限に加えて bedrock:ApplyGuardrail 権限が必要です。
Bedrock は メモリ検索 の embedding プロバイダーとしても 利用できます。これは推論プロバイダーとは別に設定します。 agents.defaults.memorySearch.provider を "bedrock" に設定してください。
{
  agents: {
    defaults: {
      memorySearch: {
        provider: "bedrock",
        model: "amazon.titan-embed-text-v2:0", // デフォルト
      },
    },
  },
}
Bedrock embeddings は、推論と同じ AWS SDK 認証情報チェーン（インスタンス ロール、SSO、アクセスキー、共有設定、Web ID）を使用します。API キーは 不要です。サポートされる embedding モデルには、Amazon Titan Embed（v1、v2）、Amazon Nova Embed、Cohere Embed（v3、v4）、TwelveLabs Marengo が含まれます。完全なモデル一覧と次元オプションについては、 メモリ設定リファレンス — Bedrock を参照してください。
  • Bedrock では、AWS アカウント/リージョンで モデルアクセス が有効になっている必要があります。
  • 自動検出には bedrock:ListFoundationModels と bedrock:ListInferenceProfiles 権限が必要です。
  • 自動モードに依存する場合は、サポートされている AWS 認証環境マーカーのいずれかを Gateway ホストに設定してください。環境マーカーなしで 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 モデルカードを 確認してください。
  • マネージドキーのフローを使用したい場合は、OpenAI 互換の プロキシを Bedrock の前段に配置し、代わりに OpenAI プロバイダーとして設定することもできます。

​
関連

モデル選択

プロバイダー、モデル ref、フェイルオーバー動作の選択。

メモリ検索

メモリ検索設定用の Bedrock embeddings。

メモリ設定リファレンス

Bedrock embedding モデルの完全な一覧と次元オプション。

トラブルシューティング

一般的なトラブルシューティングと FAQ。