Providers
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 permukaan
/v1/chat/completions standar yang didukung oleh infrastruktur Bedrock.
| Properti | Nilai |
|---|---|
| ID penyedia | amazon-bedrock-mantle |
| API | openai-completions (kompatibel dengan OpenAI) atau anthropic-messages (rute Anthropic Messages) |
| Auth | AWS_BEARER_TOKEN_BEDROCK eksplisit atau pembuatan token bearer rantai kredensial IAM |
| Region default | us-east-1 (timpa dengan AWS_REGION atau AWS_DEFAULT_REGION) |
Memulai
Pilih metode auth yang Anda inginkan dan ikuti langkah-langkah penyiapan.
Token bearer eksplisit
Terbaik untuk: lingkungan tempat Anda sudah memiliki token bearer Mantle.
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"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.
Verifikasi model ditemukan
openclaw models listModel yang ditemukan muncul di bawah penyedia amazon-bedrock-mantle. Tidak ada
config tambahan yang diperlukan kecuali Anda ingin menimpa default.
Kredensial IAM
Terbaik untuk: menggunakan kredensial yang kompatibel dengan AWS SDK (config bersama, SSO, identitas web, peran instance atau tugas).
Konfigurasikan kredensial AWS di host gateway
Sumber auth apa pun yang kompatibel dengan AWS SDK dapat digunakan:
export AWS_PROFILE="default"export AWS_REGION="us-west-2"Verifikasi model ditemukan
openclaw models listOpenClaw membuat token bearer Mantle dari rantai kredensial secara otomatis.
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.
| Perilaku | Detail |
|---|---|
| Cache penemuan | Hasil disimpan di cache selama 1 jam |
| Penyegaran token IAM | Setiap 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 falseRegion 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
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.
Endpoint tidak tersedia
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.
Claude Opus 4.7 melalui rute Anthropic Messages
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, }, ], }, }, },}Hubungan dengan penyedia Amazon Bedrock
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.
