Amazon Bedrock Mantle

OpenClaw menyertakan penyedia Amazon Bedrock Mantle bawaan yang terhubung ke endpoint Mantle yang kompatibel dengan OpenAI. Mantle menghosting model sumber terbuka dan pihak ketiga (GPT-OSS, Qwen, Kimi, GLM, dan sejenisnya) melalui antarmuka standar /v1/chat/completions yang didukung oleh infrastruktur Bedrock. Mantle juga menyediakan model Anthropic Claude melalui rute Anthropic Messages.

Properti	Nilai
ID penyedia	`amazon-bedrock-mantle`
API	`openai-completions` untuk model OSS yang ditemukan, `anthropic-messages` untuk model Claude
Autentikasi	`AWS_BEARER_TOKEN_BEDROCK` eksplisit atau pembuatan token pembawa melalui rantai kredensial IAM
Wilayah default	`us-east-1` (ganti dengan `AWS_REGION` atau `AWS_DEFAULT_REGION`)

Memulai

Pilih metode autentikasi yang Anda inginkan dan ikuti langkah-langkah penyiapannya.

Token pembawa eksplisit
Kredensial IAM

Paling cocok untuk: lingkungan tempat Anda sudah memiliki token pembawa Mantle.

Tetapkan token pembawa pada host Gateway

export AWS_BEARER_TOKEN_BEDROCK="..."

Tetapkan wilayah jika diperlukan (default-nya us-east-1):

export AWS_REGION="us-west-2"

Verifikasi bahwa model ditemukan

openclaw models list

Model yang ditemukan muncul di bawah penyedia amazon-bedrock-mantle. Tidak diperlukan konfigurasi tambahan kecuali jika Anda ingin mengganti nilai default.

Paling cocok untuk: menggunakan kredensial yang kompatibel dengan AWS SDK (konfigurasi bersama, SSO, identitas web, serta peran instans atau tugas).

Konfigurasikan kredensial AWS pada host Gateway

Semua sumber autentikasi yang kompatibel dengan AWS SDK dapat digunakan:

export AWS_PROFILE="default"
export AWS_REGION="us-west-2"

Verifikasi bahwa model ditemukan

openclaw models list

OpenClaw secara otomatis menghasilkan token pembawa Mantle dari rantai kredensial.

Saat AWS_BEARER_TOKEN_BEDROCK tidak ditetapkan, OpenClaw membuat token pembawa untuk Anda dari rantai kredensial default AWS, termasuk kredensial/profil konfigurasi bersama, SSO, identitas web, serta peran instans atau tugas.

Penemuan model otomatis

Saat AWS_BEARER_TOKEN_BEDROCK ditetapkan, OpenClaw menggunakannya secara langsung. Jika tidak, OpenClaw mencoba menghasilkan token pembawa Mantle dari rantai kredensial default AWS. Kemudian, OpenClaw menemukan model Mantle yang tersedia dengan mengirim kueri ke endpoint /v1/models wilayah tersebut.

Perilaku	Detail
Cache penemuan	Hasil disimpan dalam cache selama 1 jam per wilayah; kegagalan pengambilan mengembalikan hasil cache terakhir
Penyegaran token IAM	Setiap 2 jam, disimpan dalam cache per wilayah

Untuk mempertahankan Plugin Mantle tetap aktif, tetapi menonaktifkan penemuan otomatis dan pembuatan token pembawa IAM, nonaktifkan pengalih penemuan milik Plugin:

openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false

Token pembawa tersebut sama dengan AWS_BEARER_TOKEN_BEDROCK yang digunakan oleh penyedia standar Amazon Bedrock.

Wilayah yang didukung

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.

Konfigurasi manual

Jika Anda lebih memilih konfigurasi eksplisit daripada penemuan otomatis:

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

Daftar models eksplisit yang tidak kosong bersifat otoritatif dan menggantikan setiap baris yang ditemukan, termasuk baris Claude di bawah. Hilangkan models untuk mempertahankan katalog Mantle otomatis, atau sertakan entri lengkap model Claude yang ingin Anda gunakan.

Konfigurasi lanjutan

Dukungan penalaran

Dukungan penalaran disimpulkan dari ID model yang berisi pola seperti thinking, reasoner, reasoning, deepseek.r, gpt-oss-120b, atau gpt-oss-safeguard-120b. OpenClaw secara otomatis menetapkan reasoning: true untuk model yang cocok selama penemuan.

Ketidaktersediaan endpoint

Jika endpoint Mantle tidak tersedia, tidak mengembalikan model, atau resolusi token pembawa gagal, penemuan mengembalikan hasil kosong dan penyedia implisit dilewati. OpenClaw tidak menghasilkan galat; penyedia lain yang dikonfigurasi tetap berfungsi seperti biasa.

Claude melalui rute Anthropic Messages

Saat penemuan otomatis mengelola daftar model, OpenClaw menambahkan empat model Claude setelah pencarian berhasil, terlepas dari hasil yang dikembalikan oleh /v1/models: amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5), amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7), dan amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5), ditambah amazon-bedrock-mantle/anthropic.claude-mythos-preview (Claude Mythos Preview). Model-model tersebut menggunakan antarmuka API anthropic-messages dan melakukan streaming melalui endpoint kompatibel Anthropic yang sama dan diautentikasi dengan token pembawa (<mantle-base>/anthropic), sehingga token pembawa AWS tidak diperlakukan seperti kunci API Anthropic.Claude Sonnet 5 selalu menggunakan pemikiran adaptif dan secara default memakai tingkat upaya high. /think off dan /think minimal dipetakan ke low karena rute Mantle tidak dapat menonaktifkan pemikiran. OpenClaw juga tidak menyertakan suhu khusus untuk permintaan Sonnet 5.Akses ke Claude Mythos 5 dibatasi. Model ini menyediakan jendela konteks 1.000.000 token dan batas keluaran 128.000 token, selalu menggunakan pemikiran adaptif, memetakan /think off dan /think minimal ke low, serta tidak menyertakan parameter pengambilan sampel yang dipilih pemanggil.Claude Mythos Preview selalu meminta penalaran, dengan tingkat upaya default high saat tidak ada tingkat /think yang ditetapkan (xhigh/max dipetakan turun ke high, dan minimal dinaikkan ke low). Opus 4.7 pada Mantle melakukan streaming tanpa penalaran yang disediakan model, dan OpenClaw tidak menyertakan parameter temperature karena Opus 4.7 tidak menerima penggantian pengambilan sampel pada rute ini; Mythos Preview menerima penggantian temperature seperti biasa.Daftar models.providers["amazon-bedrock-mantle"].models eksplisit yang tidak kosong menggantikan seluruh katalog yang ditemukan. Hilangkan daftar tersebut jika Anda menginginkan baris Claude bawaan ini.

Hubungan dengan penyedia Amazon Bedrock

Bedrock Mantle adalah penyedia yang terpisah dari penyedia standar Amazon Bedrock. Mantle menggunakan antarmuka /v1 yang kompatibel dengan OpenAI untuk katalog OSS-nya, sedangkan penyedia standar Bedrock menggunakan API Bedrock Converse native.Kedua penyedia menggunakan kredensial AWS_BEARER_TOKEN_BEDROCK yang sama jika tersedia.

Terkait

Amazon Bedrock

Penyedia Bedrock native untuk Anthropic Claude, Titan, dan model lainnya.

Pemilihan model

Memilih penyedia, referensi model, dan perilaku failover.

OAuth dan autentikasi

Detail autentikasi dan aturan penggunaan ulang kredensial.

Pemecahan masalah

Masalah umum dan cara mengatasinya.

Overview

Concepts and configuration

Providers

Amazon Bedrock Mantle

Memulai

Penemuan model otomatis

Wilayah yang didukung

Konfigurasi manual

Konfigurasi lanjutan

Terkait

Amazon Bedrock

Pemilihan model

OAuth dan autentikasi

Pemecahan masalah

​Memulai

​Penemuan model otomatis

​Wilayah yang didukung

​Konfigurasi manual

​Konfigurasi lanjutan

​Terkait

Amazon Bedrock

Pemilihan model

OAuth dan autentikasi

Pemecahan masalah

Memulai

Penemuan model otomatis

Wilayah yang didukung

Konfigurasi manual

Konfigurasi lanjutan

Terkait