Providers
Amazon Bedrock
OpenClaw, Bedrock Converse akış sağlayıcısı aracılığıyla Amazon Bedrock modellerini kullanabilir. Bedrock kimlik doğrulaması API anahtarı yerine AWS SDK varsayılan kimlik bilgisi zincirini kullanır.
| Özellik | Değer |
|---|---|
| Sağlayıcı | amazon-bedrock |
| API | bedrock-converse-stream |
| Kimlik doğrulama | AWS kimlik bilgileri (ortam değişkenleri, paylaşılan yapılandırma veya örnek rolü) |
| Bölge | AWS_REGION veya AWS_DEFAULT_REGION (varsayılan: us-east-1) |
Başlarken
Tercih ettiğiniz kimlik doğrulama yöntemini seçin ve kurulum adımlarını izleyin.
Erişim anahtarları / ortam değişkenleri
En uygun olduğu durumlar: AWS kimlik bilgilerini doğrudan yönettiğiniz geliştirici makineleri, CI veya ana makineler.
Gateway ana makinesinde AWS kimlik bilgilerini ayarlayın
export AWS_ACCESS_KEY_ID="EXAMPLE_AWS_ACCESS_KEY_ID"export AWS_SECRET_ACCESS_KEY="..."export AWS_REGION="us-east-1"# İsteğe bağlı:export AWS_SESSION_TOKEN="..."export AWS_PROFILE="your-profile"# İsteğe bağlı (Bedrock API anahtarı/taşıyıcı belirteci):export AWS_BEARER_TOKEN_BEDROCK="..."Yapılandırmanıza bir Bedrock sağlayıcısı ve modeli ekleyin
apiKey gerekli değildir. Sağlayıcıyı auth: "aws-sdk" ile yapılandırın:
{ models: { providers: { "amazon-bedrock": { baseUrl: "https://bedrock-runtime.us-east-1.amazonaws.com", api: "bedrock-converse-stream", auth: "aws-sdk", models: [ { id: "us.anthropic.claude-opus-4-6-v1", name: "Claude Opus 4.6 (Bedrock)", reasoning: true, input: ["text", "image"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 200000, maxTokens: 8192, }, ], }, }, }, agents: { defaults: { model: { primary: "amazon-bedrock/us.anthropic.claude-opus-4-6-v1" }, }, },}Modellerin kullanılabilir olduğunu doğrulayın
openclaw models listEC2 örnek rolleri (IMDS)
En uygun olduğu durumlar: Kimlik doğrulama için örnek meta veri hizmetini kullanan ve IAM rolü iliştirilmiş EC2 örnekleri.
Keşfi açıkça etkinleştirin
IMDS kullanılırken OpenClaw, AWS kimlik doğrulamasını yalnızca ortam işaretçilerinden algılayamaz; bu nedenle açıkça etkinleştirmeniz gerekir:
openclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1İsteğe bağlı olarak otomatik mod için ortam işaretçisi ekleyin
Ortam işaretçisiyle otomatik algılama yolunun da çalışmasını istiyorsanız (örneğin openclaw status yüzeyleri için):
export AWS_PROFILE=defaultexport AWS_REGION=us-east-1Sahte bir API anahtarına ihtiyacınız yoktur.
Modellerin keşfedildiğini doğrulayın
openclaw models listOtomatik model keşfi
OpenClaw, akış ve metin çıktısını destekleyen Bedrock modellerini otomatik olarak keşfedebilir. Keşif, bedrock:ListFoundationModels ve bedrock:ListInferenceProfiles kullanır ve sonuçlar önbelleğe alınır (varsayılan: 1 saat).
Örtük sağlayıcının etkinleştirilme biçimi:
- Eğer
plugins.entries.amazon-bedrock.config.discovery.enabled,trueise, OpenClaw hiçbir AWS ortam işaretçisi bulunmadığında bile keşfi dener. - Eğer
plugins.entries.amazon-bedrock.config.discovery.enabledayarlanmamışsa, OpenClaw örtük Bedrock sağlayıcısını yalnızca şu AWS kimlik doğrulama işaretçilerinden birini gördüğünde otomatik olarak ekler:AWS_BEARER_TOKEN_BEDROCK,AWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEYveyaAWS_PROFILE. - Asıl Bedrock çalışma zamanı kimlik doğrulama yolu yine AWS SDK varsayılan zincirini kullanır; dolayısıyla
keşfin etkinleştirilmesi için
enabled: truegerekmiş olsa bile paylaşılan yapılandırma, SSO ve IMDS örnek rolüyle kimlik doğrulama çalışabilir.
Keşif yapılandırma seçenekleri
Yapılandırma seçenekleri plugins.entries.amazon-bedrock.config.discovery altında bulunur:
{ plugins: { entries: { "amazon-bedrock": { config: { discovery: { enabled: true, region: "us-east-1", providerFilter: ["anthropic", "amazon"], refreshInterval: 3600, defaultContextWindow: 32000, defaultMaxTokens: 4096, }, }, }, }, },}| Seçenek | Varsayılan | Açıklama |
|---|---|---|
enabled |
otomatik | Otomatik modda OpenClaw, örtük Bedrock sağlayıcısını yalnızca desteklenen bir AWS ortam işaretçisi gördüğünde etkinleştirir. Keşfi zorlamak için true olarak ayarlayın. |
region |
AWS_REGION / AWS_DEFAULT_REGION / us-east-1 |
Keşif API çağrılarında kullanılan AWS bölgesi. |
providerFilter |
(tümü) | Bedrock sağlayıcı adlarıyla eşleşir (örneğin anthropic, amazon). |
refreshInterval |
3600 |
Saniye cinsinden önbellek süresi. Önbelleğe almayı devre dışı bırakmak için 0 olarak ayarlayın. |
defaultContextWindow |
32000 |
Bilinen belirteç sınırları olmayan keşfedilmiş modeller için kullanılan bağlam penceresi (model sınırlarınızı biliyorsanız geçersiz kılın). |
defaultMaxTokens |
4096 |
Bilinen belirteç sınırları olmayan keşfedilmiş modeller için kullanılan en fazla çıktı belirteci sayısı (model sınırlarınızı biliyorsanız geçersiz kılın). |
Bağlam penceresi ve en fazla belirteç sınırları
Bedrock ListFoundationModels ve GetFoundationModel API'leri
belirteç sınırı meta verisi döndürmez; yalnızca model kimliğini, adını, kiplerini ve yaşam döngüsü
durumunu döndürür. OpenClaw, oturum yönetiminin, Compaction eşiklerinin ve
bağlam taşması algılamasının bu modellerde doğru çalışması için popüler Bedrock
modellerinin (Claude, Nova, Llama, Mistral, DeepSeek ve diğerleri) bilinen bağlam
pencereleri ve çıktı sınırlarını içeren bir arama tablosuyla birlikte gelir.
Tabloda bulunmayan keşfedilmiş modeller defaultContextWindow
ve defaultMaxTokens değerlerine geri döner. Kullandığınız bir modelin
doğru sınırları eksikse açık bir
models.providers["amazon-bedrock"].models girdisiyle bu değerleri geçersiz kılın.
Hızlı kurulum (AWS yolu)
Bu adım adım kılavuz bir IAM rolü oluşturur, Bedrock izinlerini iliştirir, örnek profilini bağlar ve EC2 ana makinesinde OpenClaw keşfini etkinleştirir.
# 1. IAM rolünü ve örnek profilini oluşturunaws iam create-role --role-name EC2-Bedrock-Access \ --assume-role-policy-document '{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Principal": {"Service": "ec2.amazonaws.com"}, "Action": "sts:AssumeRole" }] }' aws iam attach-role-policy --role-name EC2-Bedrock-Access \ --policy-arn arn:aws:iam::aws:policy/AmazonBedrockFullAccess aws iam create-instance-profile --instance-profile-name EC2-Bedrock-Accessaws iam add-role-to-instance-profile \ --instance-profile-name EC2-Bedrock-Access \ --role-name EC2-Bedrock-Access # 2. EC2 örneğinize iliştirinaws ec2 associate-iam-instance-profile \ --instance-id i-xxxxx \ --iam-instance-profile Name=EC2-Bedrock-Access # 3. EC2 örneğinde keşfi açıkça etkinleştirinopenclaw config set plugins.entries.amazon-bedrock.config.discovery.enabled trueopenclaw config set plugins.entries.amazon-bedrock.config.discovery.region us-east-1 # 4. İsteğe bağlı: açıkça etkinleştirmeden otomatik modu kullanmak istiyorsanız bir ortam işaretçisi ekleyinecho 'export AWS_PROFILE=default' >> ~/.bashrcecho 'export AWS_REGION=us-east-1' >> ~/.bashrcsource ~/.bashrc # 5. Modellerin keşfedildiğini doğrulayınopenclaw models listGelişmiş yapılandırma
Çıkarım profilleri
OpenClaw, temel modellerle birlikte bölgesel ve küresel çıkarım profillerini
keşfeder. Bir profil bilinen bir temel modelle eşleştiğinde profil, o modelin
yeteneklerini (bağlam penceresi, en fazla belirteç sayısı, akıl yürütme, görsel işleme)
devralır ve doğru Bedrock istek bölgesi otomatik olarak eklenir. Böylece bölgeler arası
Claude profilleri, sağlayıcıyı elle geçersiz kılmaya gerek kalmadan çalışır. Küresel
bölgeler arası profiller (global.*), genellikle daha iyi kapasite
ve otomatik yük devretme sunduklarından openclaw models list içinde ilk sırada listelenir.
Çıkarım profili kimlikleri us.anthropic.claude-opus-4-6-v1 (bölgesel)
veya anthropic.claude-opus-4-6-v1 (küresel) biçimindedir. Temel model keşif
sonuçlarında zaten bulunuyorsa profil, modelin tüm yetenek kümesini devralır;
aksi takdirde güvenli varsayılanlar uygulanır.
Ek yapılandırma gerekmez. Keşif etkin olduğu ve IAM sorumlusu
bedrock:ListInferenceProfiles iznine sahip olduğu sürece profiller,
openclaw models list içinde temel modellerin yanında görünür.
Hizmet katmanı
Bazı Bedrock modelleri maliyeti veya gecikmeyi optimize etmek için
service_tier parametresini destekler. Şu katmanlar kullanılabilir:
| Katman | Açıklama |
|---|---|
default |
Standart Bedrock katmanı |
flex |
Daha uzun gecikmeyi tolere edebilen iş yükleri için indirimli işleme |
priority |
Gecikmeye duyarlı iş yükleri için öncelikli işleme |
reserved |
Kararlı durumdaki iş yükleri için ayrılmış kapasite |
Bedrock model istekleri için serviceTier (veya service_tier)
değerini agents.defaults.params aracılığıyla ya da model bazında
agents.defaults.models["<model-key>"].params içinde ayarlayın:
{ agents: { defaults: { params: { serviceTier: "flex", // tüm modellere uygulanır }, models: { "amazon-bedrock/mistral.mistral-large-3-675b-instruct": { params: { serviceTier: "priority", // model bazında geçersiz kılma }, }, }, }, },}Geçerli değerler default, flex, priority ve reserved değerleridir. Claude
Fable 5, Opus 5 ve Sonnet 5 yalnızca default katmanını destekler; bu modeller için
flex, priority veya reserved istendiğinde OpenClaw uyarı verir ve
isteği yok sayar. Diğer modellerde her model her katmanı desteklemez; desteklenmeyen bir katman
Bedrock doğrulama hatası döndürür ve hata mesajı yanıltıcı olabilir
(örneğin, sorunun katman olduğunu belirtmek yerine "The provided model identifier is invalid"
mesajını verebilir). Bu hatayı görürseniz modelin istenen katmanı destekleyip
desteklemediğini kontrol edin.
Claude Opus 5, 4.8 ve 4.7 sıcaklığı
Bedrock, Claude Opus 5, Opus 4.8 ve Opus 4.7 için temperature
parametresini reddeder. OpenClaw; temel model kimlikleri, adlandırılmış çıkarım profilleri,
temelindeki modeli bedrock:GetInferenceProfile aracılığıyla Opus 5/4.8/4.7 olarak çözümlenen uygulama
çıkarım profilleri ve isteğe bağlı bölge ön eklerine sahip noktalı
opus-4.7/opus-4.8 varyantları (us., eu., ap., apac., au., jp.,
global.) dâhil olmak üzere eşleşen tüm Bedrock referanslarında temperature
değerini otomatik olarak çıkarır. Herhangi bir yapılandırma ayarı gerekmez ve bu çıkarma hem
istek seçenekleri nesnesine hem de inferenceConfig yük alanına uygulanır.
Claude Opus 5
Messages-API Bedrock uç noktasında amazon-bedrock/anthropic.claude-opus-5 değerini
veya Bedrock keşfinde göründüğünde global.anthropic.claude-opus-5 gibi bölgesel/küresel
bir çıkarım profilini kullanın. OpenClaw; 1.000.000 token bağlam penceresini,
128.000 token çıktı sınırını, görüntü girdisini, istem önbelleğe almayı,
ret durumuna dayanıklı akışı ve yerel xhigh/max
çaba düzeylerini uygular.
Uyarlanabilir düşünme varsayılan olarak high değerini kullanır.
/think off düşünmeyi devre dışı bırakırken /think xhigh|max uyarlanabilir düşünmeyi
etkin tutar. OpenClaw, özel örnekleme parametrelerini ve desteklenmeyen
varsayılan dışı hizmet katmanlarını çıkarır.
Claude Fable 5
us-east-1 içinde amazon-bedrock/anthropic.claude-fable-5 değerini veya
us.anthropic.claude-fable-5 gibi bölgesel çıkarım kimliklerini kullanın.
OpenClaw; Fable'ın 1M bağlam penceresini, 128K çıktı sınırını, her zaman açık
uyarlanabilir düşünmeyi ve desteklenen çaba eşlemesini uygular. /think off ve
/think minimal, low değerine eşlenir; sıcaklık ve zorunlu araç seçimi denetimleri
Opus 4.7/4.8 rotasıyla uyumlu olarak çıkarılır. Akış çıktısı, akışın ortasındaki retlerin
kısmi metni açığa çıkarmaması için Bedrock bir sonlandırma durumu döndürene kadar
bekletilir.
AWS, Fable kullanılabilir olmadan önce açık bir provider_data_share veri saklama
kabulü gerektirir. İstemler ve tamamlamalar Anthropic ile paylaşılır ve
güven ile emniyet amacıyla 30 güne kadar saklanır. Modeli etkinleştirmeden önce
Bedrock veri saklama
ayarlarını inceleyip yapılandırın.
Claude Mythos 5
Claude Mythos 5, Bedrock üzerinden yalnızca gerekli sınırlı erişim
onayına sahip hesaplar tarafından kullanılabilir. OpenClaw, anthropic.claude-mythos-5
temel modelini ve us.anthropic.claude-mythos-5 gibi bölgesel veya küresel çıkarım
profillerini tanır.
OpenClaw; 1.000.000 token bağlam penceresini, 128.000 token çıktı
sınırını, görüntü girdisini, istem önbelleğe almayı, ret durumuna dayanıklı akışı ve yerel
çaba düzeylerini uygular. Uyarlanabilir düşünme her zaman etkindir: /think off ve
/think minimal, low değerine eşlenirken xhigh ve max kullanılabilir durumda kalır.
Özel örnekleme ve zorunlu araç seçimi değerleri çıkarılır.
Claude Sonnet 5
AWS, Sonnet 5'i hem
bedrock-runtime hem de bedrock-mantle uç noktaları
için belgeler. OpenClaw, anthropic.claude-sonnet-5 Bedrock temel modelini
ve us.anthropic.claude-sonnet-5 gibi bölgesel veya küresel çıkarım profillerini
tanır. 1.000.000 token bağlam penceresini, 128.000 token çıktı sınırını,
görüntü girdisini, yerel çaba düzeylerini, istem önbelleğe almayı ve
ret durumuna dayanıklı akışı uygular.
Bedrock, Sonnet 5 için uyarlanabilir düşünmeyi etkin tutar. OpenClaw varsayılan olarak
high değerini kullanır; bu rota düşünmeyi devre dışı bırakamadığı için
/think off ve /think minimal, low değerine eşlenir.
Uyarlanabilir düşünme etkinken özel sıcaklık ve zorunlu araç seçimi değerleri
çıkarılır.
Koruma önlemleri
amazon-bedrock plugin yapılandırmasına bir guardrail nesnesi ekleyerek
Amazon Bedrock Guardrails
özelliğini tüm Bedrock model çağrılarına uygulayabilirsiniz. Koruma önlemleri; içerik filtreleme,
konu reddetme, sözcük filtreleri, hassas bilgi filtreleri ve bağlamsal
temellendirme denetimlerini zorunlu kılmanıza olanak tanır.
{ plugins: { entries: { "amazon-bedrock": { config: { guardrail: { guardrailIdentifier: "abc123", // koruma önlemi kimliği veya tam ARN guardrailVersion: "1", // sürüm numarası veya "DRAFT" streamProcessingMode: "sync", // isteğe bağlı: "sync" veya "async" trace: "enabled", // isteğe bağlı: "enabled", "disabled" veya "enabled_full" }, }, }, }, },}guardrailIdentifier ve guardrailVersion gereklidir.
| Seçenek | Açıklama |
|---|---|
guardrailIdentifier |
Koruma önlemi kimliği (ör. abc123) veya tam ARN (ör. arn:aws:bedrock:us-east-1:123456789012:guardrail/abc123). |
guardrailVersion |
Yayımlanmış sürüm numarası veya çalışma taslağı için "DRAFT". |
streamProcessingMode |
Akış sırasında koruma önlemi değerlendirmesi için "sync" veya "async". Belirtilmezse Bedrock varsayılanını kullanır. |
trace |
Hata ayıklama için "enabled" veya "enabled_full"; üretimde belirtmeyin veya "disabled" olarak ayarlayın. |
Bellek araması için gömmeler
Bedrock ayrıca bellek araması için gömme sağlayıcısı
olarak kullanılabilir. Bu, çıkarım sağlayıcısından ayrı olarak yapılandırılır;
memory.search.provider değerini "bedrock" olarak ayarlayın:
{ memory: { search: { provider: "bedrock", model: "amazon.titan-embed-text-v2:0", // varsayılan }, },}Bedrock gömmeleri, çıkarımla aynı AWS SDK kimlik bilgisi zincirini kullanır (örnek rolleri, SSO, erişim anahtarları, paylaşılan yapılandırma ve web kimliği). API anahtarı gerekmez.
Desteklenen gömme modelleri arasında Amazon Titan Embed (v1, v2), Amazon Nova Embed, Cohere Embed (v3, v4) ve TwelveLabs Marengo bulunur. Tam model listesi ve boyut seçenekleri için Bellek yapılandırması referansı -- Bedrock bölümüne bakın.
Notlar ve dikkat edilmesi gerekenler
- Bedrock, AWS hesabınızda/bölgenizde model erişiminin etkinleştirilmesini gerektirir.
- Otomatik keşif,
bedrock:ListFoundationModelsvebedrock:ListInferenceProfilesizinlerini gerektirir. - Otomatik moda güveniyorsanız Gateway ana makinesinde desteklenen AWS kimlik doğrulama ortam
işaretçilerinden birini ayarlayın. Ortam işaretçileri olmadan IMDS/paylaşılan yapılandırma
kimlik doğrulamasını tercih ediyorsanız
plugins.entries.amazon-bedrock.config.discovery.enabled: truedeğerini ayarlayın. - OpenClaw, kimlik bilgisi kaynağını şu sırayla gösterir:
AWS_BEARER_TOKEN_BEDROCK, ardındanAWS_ACCESS_KEY_ID+AWS_SECRET_ACCESS_KEY, ardındanAWS_PROFILE, ardından varsayılan AWS SDK zinciri. - Akıl yürütme desteği modele bağlıdır; güncel yetenekler için Bedrock model kartını kontrol edin.
- Yönetilen anahtar akışını tercih ediyorsanız Bedrock'ın önüne OpenAI uyumlu bir proxy yerleştirip bunun yerine OpenAI sağlayıcısı olarak yapılandırabilirsiniz.