OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Amazon Bedrock Mantle

OpenClaw, Mantle'ın OpenAI uyumlu uç noktasına bağlanan yerleşik bir Amazon Bedrock Mantle sağlayıcısı içerir. Mantle, Bedrock altyapısıyla desteklenen standart bir /v1/chat/completions yüzeyi üzerinden açık kaynak ve üçüncü taraf modelleri (GPT-OSS, Qwen, Kimi, GLM ve benzerleri) barındırır. Mantle ayrıca Anthropic Claude modellerini bir Anthropic Messages rotası üzerinden sunar.

Özellik Değer
Sağlayıcı kimliği amazon-bedrock-mantle
API Keşfedilen OSS modelleri için openai-completions, Claude modelleri için anthropic-messages
Kimlik doğrulama Açıkça belirtilen AWS_BEARER_TOKEN_BEDROCK veya IAM kimlik bilgisi zinciriyle bearer token oluşturma
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ça belirtilen bearer token

En uygun olduğu durum: Zaten bir Mantle bearer token'ına sahip olduğunuz ortamlar.

  • Bearer token'ı Gateway ana makinesinde ayarlayın

    bash
    export AWS_BEARER_TOKEN_BEDROCK="..."

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

    bash
    export AWS_REGION="us-west-2"

  • Modellerin keşfedildiğini doğrulayın

    bash
    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

    En uygun olduğu durum: AWS SDK uyumlu kimlik bilgilerinin kullanılması (paylaşılan yapılandırma, SSO, web kimliği, bulut sunucusu veya görev rolleri).

  • AWS kimlik bilgilerini Gateway ana makinesinde yapılandırın

    AWS SDK uyumlu herhangi bir kimlik doğrulama kaynağı kullanılabilir:

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

  • Modellerin keşfedildiğini doğrulayın

    bash
    openclaw models list

    OpenClaw, kimlik bilgisi zincirinden otomatik olarak bir Mantle bearer token'ı oluşturur.

    • Otomatik model keşfi

    AWS_BEARER_TOKEN_BEDROCK ayarlandığında OpenClaw bunu doğrudan kullanır. Aksi takdirde OpenClaw, AWS varsayılan kimlik bilgisi zincirinden bir Mantle bearer token'ı oluşturmaya ç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 bölge başına 1 saat önbelleğe alınır; getirme hatasında önbelleğe alınmış son sonuç döndürülür
    IAM token yenileme Bölge başına önbelleğe alınarak her 2 saatte bir

    Mantle Plugin'ini etkin tutarken otomatik keşfi ve IAM bearer token oluşturmayı engellemek için Plugin'e ait keşif geçişini devre dışı bırakın:

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

    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.

    Manuel yapılandırma

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

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

    Açıkça belirtilen ve boş olmayan bir models listesi belirleyicidir ve aşağıdaki Claude satırları dâhil keşfedilen tüm satırların yerini alır. Otomatik Mantle kataloğunu korumak için models değerini atlayın veya kullanmak istediğiniz eksiksiz Claude model girdilerini ekleyin.

    Gelişmiş yapılandırma

    Akıl yürütme desteği

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

    Uç noktanın kullanılamaması

    Mantle uç noktası kullanılamıyorsa, model döndürmüyorsa veya bearer token çözümlemesi başarısız olursa keşif boş bir sonuç döndürür ve örtük sağlayıcı atlanır. OpenClaw hata vermez; yapılandırılmış diğer sağlayıcılar normal şekilde çalışmaya devam eder.

    Anthropic Messages rotası üzerinden Claude

    Model listesini otomatik keşif yönetirken OpenClaw, /v1/models ne döndürürse döndürsün başarılı bir aramanın ardından beş Claude modeli ekler: amazon-bedrock-mantle/anthropic.claude-opus-5 (Claude Opus 5), amazon-bedrock-mantle/anthropic.claude-sonnet-5 (Claude Sonnet 5), amazon-bedrock-mantle/anthropic.claude-opus-4-7 (Claude Opus 4.7) ve amazon-bedrock-mantle/anthropic.claude-mythos-5 (Claude Mythos 5), ayrıca amazon-bedrock-mantle/anthropic.claude-mythos-preview (Claude Mythos Preview). Bunlar anthropic-messages API yüzeyini kullanır ve bearer ile kimliği doğrulanan aynı Anthropic uyumlu uç nokta (<mantle-base>/anthropic) üzerinden akış gerçekleştirir; dolayısıyla AWS bearer token'ı bir Anthropic API anahtarı olarak değerlendirilmez.

    Claude Opus 5; 1,000,000 token'lık bağlam penceresi, 128,000 token'lık çıktı sınırı, görüntü girdisi ve $5/$25 girdi/çıktı fiyatlandırması sunar. Uyarlanabilir düşünmenin varsayılanı high değeridir; /think off düşünmeyi devre dışı bırakır ve /think xhigh|max modelin yerel çaba düzeylerini kullanır. OpenClaw, çağıranın seçtiği örnekleme parametrelerini atlar.

    Claude Sonnet 5 her zaman uyarlanabilir düşünmeyi kullanır ve varsayılan çaba düzeyi high değeridir. Mantle rotası düşünmeyi devre dışı bırakamadığından /think off ve /think minimal, low ile eşlenir. OpenClaw ayrıca Sonnet 5 istekleri için özel sıcaklık değerini atlar.

    Claude Mythos 5 sınırlı erişime sahiptir. 1,000,000 token'lık bağlam penceresi ve 128,000 token'lık çıktı sınırı sunar, her zaman uyarlanabilir düşünmeyi kullanır, /think off ve /think minimal değerlerini low ile eşler ve çağıranın seçtiği örnekleme parametrelerini atlar.

    Claude Mythos Preview her zaman akıl yürütme ister; hiçbir /think düzeyi ayarlanmadığında varsayılan çaba düzeyi high olur (xhigh/max değerlerinden high değerine düşürülür, minimal değerinden low değerine yükseltilir). Mantle üzerindeki Opus 4.7, model tarafından sağlanan akıl yürütme olmadan akış gerçekleştirir ve Opus 4.7 bu rotada örnekleme geçersiz kılmalarını kabul etmediğinden OpenClaw temperature parametresini atlar; Mythos Preview ise bir temperature geçersiz kılmasını normal şekilde kabul eder.

    Boş olmayan ve açıkça belirtilmiş bir models.providers["amazon-bedrock-mantle"].models listesi, keşfedilen kataloğun tamamının yerini alır. Bu yerleşik Claude satırlarını istediğinizde bu listeyi atlayın.

    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, OSS kataloğu için OpenAI uyumlu bir /v1 yüzeyi kullanırken standart Bedrock sağlayıcısı yerel Bedrock Converse API'sini kullanır.

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

    İlgili kaynaklar

    Amazon Bedrock

    Anthropic Claude, Titan ve diğer modeller için yerel Bedrock sağlayıcısı.
    Model seçimi

    Sağlayıcıların, model referanslarının ve yük devretme davranışının seçilmesi.
    OAuth ve kimlik doğrulama

    Kimlik doğrulama ayrıntıları ve kimlik bilgilerini yeniden kullanma kuralları.
    Sorun giderme

    Yaygın sorunlar ve bunların nasıl çözüleceği.
    Was this useful?
    On this page

    On this page