Providers

Amazon Bedrock Mantle

OpenClaw, Mantle OpenAI uyumlu uç noktaya bağlanan paketle gelen bir Amazon Bedrock Mantle sağlayıcısı içerir. Mantle, açık kaynak ve üçüncü taraf modelleri (GPT-OSS, Qwen, Kimi, GLM ve benzerleri) Bedrock altyapısı tarafından desteklenen standart bir /v1/chat/completions yüzeyi üzerinden barındırır.

Özellik Değer
Sağlayıcı ID amazon-bedrock-mantle
API openai-completions (OpenAI uyumlu) veya anthropic-messages (Anthropic Messages yolu)
Kimlik doğrulama Açık AWS_BEARER_TOKEN_BEDROCK veya IAM kimlik bilgisi zinciriyle bearer token üretimi
Varsayılan bölge us-east-1 (AWS_REGION veya AWS_DEFAULT_REGION ile geçersiz kılınabilir)

Başlarken

Tercih ettiğiniz kimlik doğrulama yöntemini seçin ve kurulum adımlarını izleyin.

Açık bearer token

Şunun için en uygunu: elinizde zaten bir Mantle bearer token bulunan ortamlar.

  • Gateway ana bilgisayarında bearer token ayarlayın

    export AWS_BEARER_TOKEN_BEDROCK="..."
    

    İsteğe bağlı olarak bir bölge ayarlayın (varsayılan us-east-1):

    export AWS_REGION="us-west-2"
    
  • Modellerin keşfedildiğini doğrulayın

    openclaw models list
    

    Keşfedilen modeller amazon-bedrock-mantle sağlayıcısı altında görünür. Varsayılanları geçersiz kılmak istemediğiniz sürece ek yapılandırma gerekmez.

  • IAM kimlik bilgileri

    Şunun için en uygunu: AWS SDK uyumlu kimlik bilgileri kullanmak (paylaşılan yapılandırma, SSO, web identity, instance veya task rolleri).

  • Gateway ana bilgisayarında AWS kimlik bilgilerini yapılandırın

    AWS SDK uyumlu herhangi bir kimlik doğrulama kaynağı çalışır:

    export AWS_PROFILE="default"
    export AWS_REGION="us-west-2"
    
  • Modellerin keşfedildiğini doğrulayın

    openclaw models list
    

    OpenClaw, kimlik bilgisi zincirinden otomatik olarak bir Mantle bearer token üretir.

  • Otomatik model keşfi

    AWS_BEARER_TOKEN_BEDROCK ayarlandığında OpenClaw bunu doğrudan kullanır. Aksi durumda OpenClaw, AWS varsayılan kimlik bilgisi zincirinden bir Mantle bearer token üretmeye çalışır. Ardından bölgenin /v1/models uç noktasını sorgulayarak kullanılabilir Mantle modellerini keşfeder.

    Davranış Ayrıntı
    Keşif önbelleği Sonuçlar 1 saat önbelleklenir
    IAM token yenileme Saatlik

    Desteklenen bölgeler

    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.

    Elle yapılandırma

    Otomatik keşif yerine açık yapılandırma tercih ediyorsanız:

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

    Gelişmiş yapılandırma

    Akıl yürütme desteği

    Akıl yürütme desteği, thinking, reasoner veya gpt-oss-120b gibi kalıpları içeren model kimliklerinden çıkarılır. OpenClaw, keşif sırasında eşleşen modeller için otomatik olarak reasoning: true ayarlar.

    Uç nokta kullanılamıyor

    Mantle uç noktası kullanılamıyorsa veya hiç model döndürmüyorsa sağlayıcı sessizce atlanır. OpenClaw hata vermez; yapılandırılmış diğer sağlayıcılar normal şekilde çalışmaya devam eder.

    Anthropic Messages yolu üzerinden Claude Opus 4.7

    Mantle, Claude modellerini aynı bearer kimlik doğrulamalı akış yolu üzerinden taşıyan bir Anthropic Messages yolu da sunar. Claude Opus 4.7 (amazon-bedrock-mantle/claude-opus-4.7) bu yol üzerinden sağlayıcıya ait akış ile çağrılabilir; böylece AWS bearer token'ları Anthropic API anahtarları gibi değerlendirilmez.

    Mantle sağlayıcısında bir Anthropic Messages modelini sabitlediğinizde OpenClaw, o model için openai-completions yerine anthropic-messages API yüzeyini kullanır. Kimlik doğrulama yine AWS_BEARER_TOKEN_BEDROCK değerinden (veya üretilen IAM bearer token'ından) gelir.

    {
      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,
              },
            ],
          },
        },
      },
    }
    
    Amazon Bedrock sağlayıcısıyla ilişkisi

    Bedrock Mantle, standart Amazon Bedrock sağlayıcısından ayrı bir sağlayıcıdır. Mantle bir OpenAI uyumlu /v1 yüzeyi kullanırken standart Bedrock sağlayıcısı yerel Bedrock API'sini kullanır.

    Her iki sağlayıcı da, mevcut olduğunda aynı AWS_BEARER_TOKEN_BEDROCK kimlik bilgisini paylaşır.

    İlgili