Langsung ke konten utama
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 permukaan /v1/chat/completions standar yang didukung oleh infrastruktur Bedrock.
PropertiNilai
ID penyediaamazon-bedrock-mantle
APIopenai-completions (kompatibel dengan OpenAI) atau anthropic-messages (rute Anthropic Messages)
AuthAWS_BEARER_TOKEN_BEDROCK eksplisit atau pembuatan token bearer rantai kredensial IAM
Region defaultus-east-1 (timpa dengan AWS_REGION atau AWS_DEFAULT_REGION)

Memulai

Pilih metode auth yang Anda inginkan dan ikuti langkah-langkah penyiapan.
Terbaik untuk: lingkungan tempat Anda sudah memiliki token bearer Mantle.
1

Atur token bearer di host gateway

export AWS_BEARER_TOKEN_BEDROCK="..."
Secara opsional, atur region (default ke us-east-1):
export AWS_REGION="us-west-2"
2

Ikut serta dalam berbagi data penyedia untuk Claude Fable 5

Claude Fable 5 dan model Bedrock kelas Claude Mythos memerlukan mode Mantle Data Retention API provider_data_share sebelum pemanggilan. Keikutsertaan ini memungkinkan Bedrock membagikan prompt dan completion dengan Anthropic dan menyimpannya hingga 30 hari untuk peninjauan kepercayaan dan keamanan.
AWS_REGION="${AWS_REGION:-us-east-1}"
curl -X PUT "https://bedrock-mantle.${AWS_REGION}.api.aws/v1/data_retention" \
  -H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK" \
  -H "Content-Type: application/json" \
  -d '{ "mode": "provider_data_share" }'
Gunakan model Bedrock lain dalam config jika Anda tidak dapat menerima mode retensi tersebut.
3

Verifikasi model ditemukan

openclaw models list
Model yang ditemukan muncul di bawah penyedia amazon-bedrock-mantle. Tidak ada config tambahan yang diperlukan kecuali Anda ingin menimpa default.

Penemuan model otomatis

Saat AWS_BEARER_TOKEN_BEDROCK diatur, OpenClaw menggunakannya secara langsung. Jika tidak, OpenClaw mencoba membuat token bearer Mantle dari rantai kredensial default AWS. Kemudian OpenClaw menemukan model Mantle yang tersedia dengan mengkueri endpoint /v1/models region tersebut.
PerilakuDetail
Cache penemuanHasil disimpan di cache selama 1 jam
Penyegaran token IAMSetiap jam
Untuk menjaga Plugin Mantle tetap aktif tetapi menekan penemuan otomatis dan pembuatan token bearer IAM, nonaktifkan toggle penemuan milik Plugin:
openclaw config set plugins.entries.amazon-bedrock-mantle.config.discovery.enabled false
Token bearer adalah AWS_BEARER_TOKEN_BEDROCK yang sama dengan yang digunakan oleh penyedia Amazon Bedrock standar.

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

Konfigurasi lanjutan

Dukungan reasoning disimpulkan dari ID model yang berisi pola seperti thinking, reasoner, atau gpt-oss-120b. OpenClaw mengatur reasoning: true secara otomatis untuk model yang cocok selama penemuan.
Jika endpoint Mantle tidak tersedia atau tidak mengembalikan model, penyedia dilewati secara diam-diam. OpenClaw tidak menghasilkan error; penyedia lain yang dikonfigurasi tetap bekerja secara normal.
Mantle juga mengekspos rute Anthropic Messages yang membawa model Claude melalui jalur streaming terautentikasi bearer yang sama. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) dapat dipanggil melalui rute ini dengan streaming milik penyedia, sehingga token bearer AWS tidak diperlakukan seperti kunci API Anthropic.Saat Anda menyematkan model Anthropic Messages pada penyedia Mantle, OpenClaw menggunakan permukaan API anthropic-messages alih-alih openai-completions untuk model tersebut. Auth tetap berasal dari AWS_BEARER_TOKEN_BEDROCK (atau token bearer IAM yang diterbitkan).
{
  models: {
    providers: {
      "amazon-bedrock-mantle": {
        models: [
          {
            id: "claude-opus-4.7",
            name: "Claude Opus 4.7",
            api: "anthropic-messages",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1000000,
            maxTokens: 32000,
          },
        ],
      },
    },
  },
}
Bedrock Mantle adalah penyedia terpisah dari penyedia Amazon Bedrock standar. Mantle menggunakan permukaan /v1 yang kompatibel dengan OpenAI, sedangkan penyedia Bedrock standar menggunakan API Bedrock native.Kedua penyedia berbagi kredensial AWS_BEARER_TOKEN_BEDROCK yang sama saat tersedia.

Terkait

Amazon Bedrock

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

Pemilihan model

Memilih penyedia, ref model, dan perilaku failover.

OAuth dan auth

Detail auth dan aturan penggunaan ulang kredensial.

Pemecahan masalah

Masalah umum dan cara menyelesaikannya.