Langsung ke konten utama

Amazon Bedrock Mantle

OpenClaw menyertakan provider Amazon Bedrock Mantle bawaan yang terhubung ke endpoint Mantle yang kompatibel dengan OpenAI. Mantle menghosting model open-source dan pihak ketiga (GPT-OSS, Qwen, Kimi, GLM, dan sejenisnya) melalui permukaan standar /v1/chat/completions yang didukung oleh infrastruktur Bedrock.
PropertyValue
ID Provideramazon-bedrock-mantle
APIopenai-completions (kompatibel OpenAI)
AutentikasiAWS_BEARER_TOKEN_BEDROCK eksplisit atau pembuatan bearer token rantai kredensial IAM
Region defaultus-east-1 (override dengan AWS_REGION atau AWS_DEFAULT_REGION)

Memulai

Pilih metode autentikasi yang Anda inginkan dan ikuti langkah penyiapannya.
Paling cocok untuk: lingkungan tempat Anda sudah memiliki bearer token Mantle.
1

Tetapkan bearer token di host gateway

export AWS_BEARER_TOKEN_BEDROCK="..."
Secara opsional tetapkan region (default-nya us-east-1):
export AWS_REGION="us-west-2"
2

Verifikasi model ditemukan

openclaw models list
Model yang ditemukan akan muncul di bawah provider amazon-bedrock-mantle. Tidak diperlukan config tambahan kecuali Anda ingin mengoverride default.

Penemuan model otomatis

Saat AWS_BEARER_TOKEN_BEDROCK diatur, OpenClaw menggunakannya secara langsung. Jika tidak, OpenClaw mencoba menghasilkan bearer token Mantle dari rantai kredensial default AWS. Setelah itu, OpenClaw menemukan model Mantle yang tersedia dengan melakukan query ke endpoint /v1/models milik region tersebut.
PerilakuDetail
Cache penemuanHasil di-cache selama 1 jam
Refresh token IAMPer jam
Bearer token ini sama dengan AWS_BEARER_TOKEN_BEDROCK yang digunakan oleh provider 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,
          },
        ],
      },
    },
  },
}

Catatan lanjutan

Dukungan reasoning disimpulkan dari ID model yang mengandung pola seperti thinking, reasoner, atau gpt-oss-120b. OpenClaw menetapkan reasoning: true secara otomatis untuk model yang cocok selama penemuan.
Jika endpoint Mantle tidak tersedia atau tidak mengembalikan model, provider ini akan dilewati secara senyap. OpenClaw tidak menghasilkan error; provider lain yang dikonfigurasi tetap berfungsi normal.
Bedrock Mantle adalah provider terpisah dari provider Amazon Bedrock standar. Mantle menggunakan permukaan /v1 yang kompatibel dengan OpenAI, sedangkan provider Bedrock standar menggunakan API Bedrock native.Kedua provider berbagi kredensial AWS_BEARER_TOKEN_BEDROCK yang sama jika tersedia.

Terkait

Amazon Bedrock

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

Pemilihan model

Memilih provider, ref model, dan perilaku failover.

OAuth dan autentikasi

Detail autentikasi dan aturan penggunaan ulang kredensial.

Pemecahan masalah

Masalah umum dan cara menyelesaikannya.