Amazon Bedrock

Opsi konfigurasi berada di bawah 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,          },        },      },    },  },}

API ListFoundationModels dan GetFoundationModel Bedrock tidak mengembalikan metadata batas token, hanya ID model, nama, modalitas, dan status siklus hidup. OpenClaw menyertakan tabel pencarian jendela konteks dan batas keluaran yang diketahui untuk model Bedrock populer (Claude, Nova, Llama, Mistral, DeepSeek, dan lainnya) agar pengelolaan sesi, ambang batas Compaction, dan deteksi luapan konteks berfungsi dengan benar untuk model-model tersebut.

Model yang ditemukan tetapi tidak ada dalam tabel akan menggunakan defaultContextWindow dan defaultMaxTokens sebagai nilai cadangan. Jika model yang Anda gunakan tidak memiliki batas yang akurat, timpa dengan entri models.providers["amazon-bedrock"].models eksplisit.

OpenClaw menemukan profil inferensi regional dan global bersama model fondasi. Ketika profil dipetakan ke model fondasi yang diketahui, profil tersebut mewarisi kemampuan model itu (jendela konteks, token maksimum, penalaran, visi), dan wilayah permintaan Bedrock yang benar disisipkan secara otomatis. Artinya, profil Claude lintas wilayah berfungsi tanpa penimpaan penyedia manual. Profil lintas wilayah global (global.*) dicantumkan terlebih dahulu di openclaw models list karena umumnya menawarkan kapasitas yang lebih baik dan failover otomatis.

ID profil inferensi terlihat seperti us.anthropic.claude-opus-4-6-v1 (regional) atau anthropic.claude-opus-4-6-v1 (global). Jika model pendukung sudah ada dalam hasil penemuan, profil akan mewarisi seluruh rangkaian kemampuannya; jika tidak, default yang aman akan diterapkan.

Tidak diperlukan konfigurasi tambahan. Selama penemuan diaktifkan dan prinsipal IAM memiliki bedrock:ListInferenceProfiles, profil akan muncul bersama model fondasi di openclaw models list.

Beberapa model Bedrock mendukung parameter service_tier untuk mengoptimalkan biaya atau latensi. Tingkat berikut tersedia:

Tetapkan serviceTier (atau service_tier) melalui agents.defaults.params untuk permintaan model Bedrock, atau per model di agents.defaults.models["<model-key>"].params:

{  agents: {    defaults: {      params: {        serviceTier: "flex", // berlaku untuk semua model      },      models: {        "amazon-bedrock/mistral.mistral-large-3-675b-instruct": {          params: {            serviceTier: "priority", // penimpaan per model          },        },      },    },  },}

Nilai yang valid adalah default, flex, priority, dan reserved. Claude Fable 5 dan Sonnet 5 hanya mendukung tingkat default; OpenClaw memperingatkan dan mengabaikan flex, priority, atau reserved yang diminta untuk model tersebut. Untuk model lain, tidak setiap model mendukung setiap tingkat -- tingkat yang tidak didukung menghasilkan kesalahan validasi Bedrock, dan pesan kesalahannya dapat menyesatkan (misalnya "Pengidentifikasi model yang diberikan tidak valid" alih-alih menyebut tingkat tersebut sebagai masalahnya). Jika Anda melihat kesalahan ini, periksa apakah model mendukung tingkat yang diminta.

Bedrock menolak parameter temperature untuk Claude Opus 4.7 dan Opus 4.8. OpenClaw menghilangkan temperature secara otomatis untuk setiap referensi Bedrock yang cocok, termasuk id model dasar, profil inferensi bernama, profil inferensi aplikasi yang model dasarnya diuraikan menjadi Opus 4.7/4.8 melalui bedrock:GetInferenceProfile, dan varian opus-4.7/opus-4.8 bertitik dengan prefiks wilayah opsional (us., eu., ap., apac., au., jp., global.). Tidak diperlukan opsi konfigurasi, dan penghilangan ini berlaku untuk objek opsi permintaan maupun bidang payload inferenceConfig.

Gunakan amazon-bedrock/anthropic.claude-fable-5 di us-east-1, atau id inferensi regional seperti us.anthropic.claude-fable-5. OpenClaw menerapkan jendela konteks 1M milik Fable, batas keluaran 128K, pemikiran adaptif yang selalu aktif, dan pemetaan tingkat upaya yang didukung. /think off dan /think minimal dipetakan ke low; kontrol temperatur dan pemilihan alat secara paksa dihilangkan, sesuai dengan rute Opus 4.7/4.8. Keluaran streaming ditahan hingga Bedrock mengembalikan status terminal agar penolakan di tengah streaming tidak mengekspos teks parsial.

AWS mewajibkan persetujuan eksplisit untuk retensi data provider_data_share sebelum Fable tersedia. Prompt dan penyelesaian dibagikan kepada Anthropic dan disimpan hingga 30 hari untuk kepercayaan dan keamanan. Tinjau dan konfigurasikan retensi data Bedrock sebelum mengaktifkan model.

Claude Mythos 5 tersedia melalui Bedrock hanya untuk akun yang memiliki persetujuan akses terbatas yang diperlukan. OpenClaw mengenali model dasar anthropic.claude-mythos-5 serta profil inferensi regional atau global seperti us.anthropic.claude-mythos-5.

OpenClaw menerapkan jendela konteks 1.000.000 token, batas keluaran 128.000 token, masukan gambar, penyimpanan cache prompt, streaming yang aman terhadap penolakan, dan tingkat upaya native. Pemikiran adaptif selalu diaktifkan: /think off dan /think minimal dipetakan ke low, sementara xhigh dan max tetap tersedia. Nilai sampling khusus dan pemilihan alat secara paksa dihilangkan.

AWS mendokumentasikan Sonnet 5 untuk endpoint bedrock-runtime dan bedrock-mantle. OpenClaw mengenali model dasar Bedrock anthropic.claude-sonnet-5 serta profil inferensi regional atau global seperti us.anthropic.claude-sonnet-5. OpenClaw menerapkan jendela konteks 1.000.000 token, batas keluaran 128.000 token, masukan gambar, tingkat upaya native, penyimpanan cache prompt, dan streaming yang aman terhadap penolakan.

Bedrock mempertahankan pemikiran adaptif tetap aktif untuk Sonnet 5. Default OpenClaw adalah high; /think off dan /think minimal dipetakan ke low karena rute ini tidak dapat menonaktifkan pemikiran. Nilai temperatur khusus dan pemilihan alat secara paksa dihilangkan saat pemikiran adaptif aktif.

Anda dapat menerapkan Amazon Bedrock Guardrails ke semua pemanggilan model Bedrock dengan menambahkan objek guardrail ke konfigurasi plugin amazon-bedrock. Guardrail memungkinkan Anda menerapkan pemfilteran konten, penolakan topik, filter kata, filter informasi sensitif, dan pemeriksaan landasan kontekstual.

{  plugins: {    entries: {      "amazon-bedrock": {        config: {          guardrail: {            guardrailIdentifier: "abc123", // ID guardrail atau ARN lengkap            guardrailVersion: "1", // nomor versi atau "DRAFT"            streamProcessingMode: "sync", // opsional: "sync" atau "async"            trace: "enabled", // opsional: "enabled", "disabled", atau "enabled_full"          },        },      },    },  },}

guardrailIdentifier dan guardrailVersion wajib diisi.

Bedrock juga dapat berfungsi sebagai penyedia embedding untuk pencarian memori. Ini dikonfigurasi secara terpisah dari penyedia inferensi -- atur agents.defaults.memorySearch.provider ke "bedrock":

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

Embedding Bedrock menggunakan rantai kredensial AWS SDK yang sama dengan inferensi (peran instans, SSO, kunci akses, konfigurasi bersama, dan identitas web). Tidak diperlukan kunci API.

Model embedding yang didukung mencakup Amazon Titan Embed (v1, v2), Amazon Nova Embed, Cohere Embed (v3, v4), dan TwelveLabs Marengo. Lihat Referensi konfigurasi memori -- Bedrock untuk daftar lengkap model dan opsi dimensi.

• Bedrock memerlukan akses model yang diaktifkan di akun/wilayah AWS Anda.
• Penemuan otomatis memerlukan izin bedrock:ListFoundationModels dan bedrock:ListInferenceProfiles.
• Jika Anda mengandalkan mode otomatis, atur salah satu penanda env autentikasi AWS yang didukung pada host gateway. Jika Anda lebih memilih autentikasi IMDS/konfigurasi bersama tanpa penanda env, atur plugins.entries.amazon-bedrock.config.discovery.enabled: true.
• OpenClaw menampilkan sumber kredensial dalam urutan berikut: AWS_BEARER_TOKEN_BEDROCK, kemudian AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY, lalu AWS_PROFILE, kemudian rantai default AWS SDK.
• Dukungan penalaran bergantung pada model; periksa kartu model Bedrock untuk kemampuan terkini.
• Jika Anda lebih memilih alur kunci terkelola, Anda juga dapat menempatkan proxy yang kompatibel dengan OpenAI di depan Bedrock dan mengonfigurasikannya sebagai penyedia OpenAI.