chore(i18n): refresh tr translations
This commit is contained in:
parent
d7fec5d181
commit
f8a5ddbcc6
@ -1,14 +1,14 @@
|
||||
---
|
||||
read_when:
|
||||
- Sağlayıcı bazında bir model kurulum başvurusuna ihtiyacınız var
|
||||
- Model sağlayıcıları için örnek yapılandırmalara veya CLI katılım komutlarına ihtiyacınız var
|
||||
summary: Örnek yapılandırmalar + CLI akışlarıyla model sağlayıcısı genel bakışı
|
||||
- Sağlayıcı bazında model kurulumu başvuru kaynağına ihtiyacınız var
|
||||
- Model sağlayıcıları için örnek yapılandırmalar veya CLI onboarding komutları istiyorsunuz
|
||||
summary: Örnek yapılandırmalar + CLI akışları ile model sağlayıcısı genel bakışı
|
||||
title: Model Sağlayıcıları
|
||||
x-i18n:
|
||||
generated_at: "2026-04-11T02:44:18Z"
|
||||
generated_at: "2026-04-13T08:50:44Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 910ea7895e74c03910757d9d3e02825754b779b204eca7275b28422647ed0151
|
||||
source_hash: 66ba688c4b4366eec07667571e835d4cfeee684896e2ffae11d601b5fa0a4b98
|
||||
source_path: concepts/model-providers.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -16,26 +16,26 @@ x-i18n:
|
||||
# Model sağlayıcıları
|
||||
|
||||
Bu sayfa **LLM/model sağlayıcılarını** kapsar (WhatsApp/Telegram gibi sohbet kanallarını değil).
|
||||
Model seçimi kuralları için bkz. [/concepts/models](/tr/concepts/models).
|
||||
Model seçim kuralları için bkz. [/concepts/models](/tr/concepts/models).
|
||||
|
||||
## Hızlı kurallar
|
||||
|
||||
- Model başvuruları `provider/model` biçimini kullanır (örnek: `opencode/claude-opus-4-6`).
|
||||
- `agents.defaults.models` ayarlarsanız, bu izin listesi haline gelir.
|
||||
- Model başvuruları `provider/model` kullanır (örnek: `opencode/claude-opus-4-6`).
|
||||
- `agents.defaults.models` ayarlarsanız, bu allowlist olur.
|
||||
- CLI yardımcıları: `openclaw onboard`, `openclaw models list`, `openclaw models set <provider/model>`.
|
||||
- Geriye dönüş çalışma zamanı kuralları, bekleme süresi sondaları ve oturum geçersiz kılma kalıcılığı
|
||||
- Yedek çalışma zamanı kuralları, cooldown probları ve oturum geçersiz kılma kalıcılığı
|
||||
[/concepts/model-failover](/tr/concepts/model-failover) içinde belgelenmiştir.
|
||||
- `models.providers.*.models[].contextWindow` doğal model meta verisidir;
|
||||
- `models.providers.*.models[].contextWindow` yerel model meta verisidir;
|
||||
`models.providers.*.models[].contextTokens` ise etkili çalışma zamanı sınırıdır.
|
||||
- Sağlayıcı eklentileri `registerProvider({ catalog })` aracılığıyla model katalogları ekleyebilir;
|
||||
- Provider Plugin'leri model kataloglarını `registerProvider({ catalog })` aracılığıyla ekleyebilir;
|
||||
OpenClaw bu çıktıyı `models.providers` içine birleştirir ve ardından
|
||||
`models.json` dosyasını yazar.
|
||||
- Sağlayıcı bildirimleri `providerAuthEnvVars` ve
|
||||
`providerAuthAliases` tanımlayabilir; böylece genel env tabanlı kimlik doğrulama yoklamaları ve sağlayıcı varyantlarının
|
||||
eklenti çalışma zamanını yüklemesi gerekmez. Çekirdekte kalan env değişkeni eşlemesi artık
|
||||
yalnızca eklenti olmayan/çekirdek sağlayıcılar ve birkaç genel öncelik durumu içindir; örneğin
|
||||
Anthropic için önce API anahtarı kullanan katılım akışı.
|
||||
- Sağlayıcı eklentileri ayrıca sağlayıcı çalışma zamanı davranışına da sahip olabilir:
|
||||
- Provider manifest'leri `providerAuthEnvVars` ve
|
||||
`providerAuthAliases` bildirebilir; böylece genel ortam tabanlı kimlik doğrulama probları ve sağlayıcı varyantları
|
||||
Plugin çalışma zamanını yüklemek zorunda kalmaz. Geriye kalan çekirdek env-var eşlemesi artık
|
||||
yalnızca Plugin olmayan/çekirdek sağlayıcılar ve Anthropic API anahtarı öncelikli onboarding gibi
|
||||
birkaç genel öncelik durumu içindir.
|
||||
- Provider Plugin'leri ayrıca sağlayıcı çalışma zamanı davranışını da sahiplenebilir:
|
||||
`normalizeModelId`, `normalizeTransport`, `normalizeConfig`,
|
||||
`applyNativeStreamingUsageCompat`, `resolveConfigApiKey`,
|
||||
`resolveSyntheticAuth`, `shouldDeferSyntheticProfileAuth`,
|
||||
@ -51,192 +51,196 @@ Model seçimi kuralları için bkz. [/concepts/models](/tr/concepts/models).
|
||||
`isCacheTtlEligible`, `buildMissingAuthMessage`, `suppressBuiltInModel`,
|
||||
`augmentModelCatalog`, `isBinaryThinking`, `supportsXHighThinking`,
|
||||
`resolveDefaultThinkingLevel`, `applyConfigDefaults`, `isModernModelRef`,
|
||||
`prepareRuntimeAuth`, `resolveUsageAuth`, `fetchUsageSnapshot`, ve
|
||||
`prepareRuntimeAuth`, `resolveUsageAuth`, `fetchUsageSnapshot` ve
|
||||
`onModelSelected`.
|
||||
- Not: sağlayıcı çalışma zamanı `capabilities` değeri, paylaşılan çalıştırıcı meta verisidir (sağlayıcı
|
||||
ailesi, döküm/araç farklılıkları, taşıma/önbellek ipuçları). Bu,
|
||||
bir eklentinin ne kaydettiğini açıklayan [genel yetenek modeli](/tr/plugins/architecture#public-capability-model)
|
||||
- Not: provider çalışma zamanı `capabilities`, paylaşılan çalıştırıcı meta verisidir (sağlayıcı
|
||||
ailesi, transkript/araçlama özellikleri, taşıma/önbellek ipuçları). Bu,
|
||||
bir Plugin'in ne kaydettiğini açıklayan [genel yetenek modeli](/tr/plugins/architecture#public-capability-model)
|
||||
ile aynı şey değildir (metin çıkarımı, konuşma vb.).
|
||||
- Paketlenmiş `codex` sağlayıcısı, paketlenmiş Codex aracı koşumuyla eşleştirilmiştir.
|
||||
Codex'e ait oturum açma, model keşfi, doğal iş parçacığı sürdürme ve
|
||||
uygulama sunucusu yürütmesi istediğinizde `codex/gpt-*` kullanın. Düz `openai/gpt-*` başvuruları ise
|
||||
- Paketlenmiş `codex` sağlayıcısı, paketlenmiş Codex ajan koşum takımı ile eşleştirilmiştir.
|
||||
Codex'e ait oturum açma, model keşfi, yerel iş parçacığı sürdürme ve
|
||||
uygulama sunucusu yürütmesi istediğinizde `codex/gpt-*` kullanın. Düz `openai/gpt-*` başvuruları
|
||||
OpenAI sağlayıcısını ve normal OpenClaw sağlayıcı taşımasını kullanmaya devam eder.
|
||||
Yalnızca Codex dağıtımları otomatik PI geri dönüşünü
|
||||
Yalnızca Codex dağıtımları, otomatik PI geri dönüşünü
|
||||
`agents.defaults.embeddedHarness.fallback: "none"` ile devre dışı bırakabilir; bkz.
|
||||
[Codex Harness](/tr/plugins/codex-harness).
|
||||
|
||||
## Eklentiye ait sağlayıcı davranışı
|
||||
## Plugin'e ait sağlayıcı davranışı
|
||||
|
||||
Sağlayıcı eklentileri artık sağlayıcıya özgü mantığın çoğuna sahip olabilirken, OpenClaw
|
||||
Provider Plugin'leri artık sağlayıcıya özgü mantığın büyük kısmını sahiplenebilirken OpenClaw
|
||||
genel çıkarım döngüsünü korur.
|
||||
|
||||
Tipik ayrım:
|
||||
|
||||
- `auth[].run` / `auth[].runNonInteractive`: sağlayıcı, `openclaw onboard`, `openclaw models auth` ve etkileşimsiz kurulum için
|
||||
katılım/oturum açma akışlarına sahip olur
|
||||
- `wizard.setup` / `wizard.modelPicker`: sağlayıcı, kimlik doğrulama seçimi etiketlerine,
|
||||
eski takma adlara, katılım izin listesi ipuçlarına ve katılım/model seçicilerindeki kurulum girdilerine sahip olur
|
||||
- `auth[].run` / `auth[].runNonInteractive`: sağlayıcı, `openclaw onboard`, `openclaw models auth` ve başsız kurulum için onboarding/oturum açma
|
||||
akışlarını sahiplenir
|
||||
- `wizard.setup` / `wizard.modelPicker`: sağlayıcı, kimlik doğrulama seçeneği etiketlerini,
|
||||
eski takma adları, onboarding allowlist ipuçlarını ve onboarding/model seçicilerdeki kurulum girişlerini sahiplenir
|
||||
- `catalog`: sağlayıcı `models.providers` içinde görünür
|
||||
- `normalizeModelId`: sağlayıcı, arama veya kurallı hale getirme öncesinde
|
||||
eski/önizleme model kimliklerini normalleştirir
|
||||
- `normalizeTransport`: sağlayıcı, genel model derlemesi öncesinde taşıma ailesi `api` / `baseUrl` değerlerini
|
||||
normalleştirir; OpenClaw önce eşleşen sağlayıcıyı,
|
||||
ardından taşıma üzerinde gerçekten değişiklik yapana kadar kanca özellikli diğer sağlayıcı eklentilerini denetler
|
||||
- `normalizeModelId`: sağlayıcı, arama veya kanonikleştirmeden önce eski/önizleme model kimliklerini
|
||||
normalize eder
|
||||
- `normalizeTransport`: sağlayıcı, genel model birleştirmesinden önce taşıma ailesi `api` / `baseUrl` değerlerini
|
||||
normalize eder; OpenClaw önce eşleşen sağlayıcıyı,
|
||||
ardından taşıma üzerinde gerçekten değişiklik yapan birini bulana kadar diğer hook yetenekli provider Plugin'lerini kontrol eder
|
||||
- `normalizeConfig`: sağlayıcı, çalışma zamanı kullanmadan önce `models.providers.<id>` yapılandırmasını
|
||||
normalleştirir; OpenClaw önce eşleşen sağlayıcıyı,
|
||||
ardından yapılandırmayı gerçekten değiştirene kadar kanca özellikli diğer sağlayıcı eklentilerini denetler. Eğer hiçbir
|
||||
sağlayıcı kancası yapılandırmayı yeniden yazmazsa, paketlenmiş Google ailesi yardımcıları yine de
|
||||
desteklenen Google sağlayıcı girdilerini normalleştirir.
|
||||
- `applyNativeStreamingUsageCompat`: sağlayıcı, yapılandırma sağlayıcıları için uç nokta güdümlü doğal akış kullanım uyumluluğu yeniden yazımlarını uygular
|
||||
- `resolveConfigApiKey`: sağlayıcı, yapılandırma sağlayıcıları için tam çalışma zamanı kimlik doğrulamasını yüklemeye zorlamadan
|
||||
env işaretleyici kimlik doğrulamasını çözümler.
|
||||
`amazon-bedrock` burada ayrıca yerleşik bir AWS env işaretleyici çözümleyicisine sahiptir; Bedrock çalışma zamanı kimlik doğrulaması
|
||||
AWS SDK varsayılan zincirini kullansa da böyledir.
|
||||
- `resolveSyntheticAuth`: sağlayıcı, düz metin gizli anahtarları kalıcı hale getirmeden
|
||||
yerel/self-hosted veya diğer yapılandırma destekli kimlik doğrulama kullanılabilirliğini açığa çıkarabilir
|
||||
- `shouldDeferSyntheticProfileAuth`: sağlayıcı, saklanan sentetik profil
|
||||
yer tutucularını env/yapılandırma destekli kimlik doğrulamadan daha düşük öncelikli olarak işaretleyebilir
|
||||
normalize eder; OpenClaw önce eşleşen sağlayıcıyı,
|
||||
ardından yapılandırmayı gerçekten değiştiren birini bulana kadar diğer
|
||||
hook yetenekli provider Plugin'lerini kontrol eder. Hiçbir sağlayıcı hook'u yapılandırmayı yeniden yazmazsa,
|
||||
paketlenmiş Google ailesi yardımcıları desteklenen Google sağlayıcı girişlerini yine de
|
||||
normalize eder.
|
||||
- `applyNativeStreamingUsageCompat`: sağlayıcı, yapılandırma sağlayıcıları için uç nokta güdümlü yerel akış kullanım uyumluluğu yeniden yazımlarını uygular
|
||||
- `resolveConfigApiKey`: sağlayıcı, tam çalışma zamanı kimlik doğrulamasının yüklenmesini zorlamadan
|
||||
yapılandırma sağlayıcıları için env-marker kimlik doğrulamasını çözer. `amazon-bedrock` burada
|
||||
yerleşik bir AWS env-marker çözücüsüne de sahiptir; Bedrock çalışma zamanı kimlik doğrulaması
|
||||
AWS SDK varsayılan zincirini kullansa da.
|
||||
- `resolveSyntheticAuth`: sağlayıcı, düz metin sırları kalıcılaştırmadan yerel/self-hosted veya diğer
|
||||
yapılandırma destekli kimlik doğrulama kullanılabilirliğini açığa çıkarabilir
|
||||
- `shouldDeferSyntheticProfileAuth`: sağlayıcı, depolanan sentetik profil yer tutucularını
|
||||
env/yapılandırma destekli kimlik doğrulamadan daha düşük öncelikli olarak işaretleyebilir
|
||||
- `resolveDynamicModel`: sağlayıcı, yerel statik katalogda henüz bulunmayan model kimliklerini kabul eder
|
||||
- `prepareDynamicModel`: sağlayıcının, dinamik çözümlemeyi yeniden denemeden önce meta veri yenilemesine ihtiyacı vardır
|
||||
- `prepareDynamicModel`: sağlayıcının, dinamik çözümlemeyi yeniden denemeden önce
|
||||
meta veri yenilemesi gerekir
|
||||
- `normalizeResolvedModel`: sağlayıcının taşıma veya temel URL yeniden yazımlarına ihtiyacı vardır
|
||||
- `contributeResolvedModelCompat`: sağlayıcı, satıcıya ait modeller başka bir uyumlu taşıma üzerinden geldiğinde bile
|
||||
bunlar için uyumluluk bayrakları sağlar
|
||||
- `capabilities`: sağlayıcı, döküm/araç/sağlayıcı ailesi farklılıklarını yayımlar
|
||||
- `normalizeToolSchemas`: sağlayıcı, gömülü çalıştırıcı bunları görmeden önce araç şemalarını temizler
|
||||
- `inspectToolSchemas`: sağlayıcı, normalleştirmeden sonra taşıma özelindeki şema uyarılarını ortaya çıkarır
|
||||
- `resolveReasoningOutputMode`: sağlayıcı, doğal ve etiketli
|
||||
akıl yürütme çıktısı sözleşmeleri arasında seçim yapar
|
||||
- `prepareExtraParams`: sağlayıcı, model başına istek parametreleri için varsayılanları ayarlar veya bunları normalleştirir
|
||||
- `createStreamFn`: sağlayıcı, normal akış yolunu tamamen
|
||||
özel bir taşıma ile değiştirir
|
||||
- `contributeResolvedModelCompat`: sağlayıcı, modeller başka bir uyumlu taşıma üzerinden gelse bile
|
||||
kendi satıcı modelleri için uyumluluk bayrakları sağlar
|
||||
- `capabilities`: sağlayıcı, transkript/araçlama/sağlayıcı ailesi özelliklerini yayımlar
|
||||
- `normalizeToolSchemas`: sağlayıcı, gömülü çalıştırıcı bunları görmeden önce
|
||||
araç şemalarını temizler
|
||||
- `inspectToolSchemas`: sağlayıcı, normalleştirmeden sonra
|
||||
taşımaya özgü şema uyarılarını ortaya çıkarır
|
||||
- `resolveReasoningOutputMode`: sağlayıcı, yerel ve etiketli
|
||||
muhakeme çıktısı sözleşmeleri arasında seçim yapar
|
||||
- `prepareExtraParams`: sağlayıcı, model başına istek parametrelerini varsayılan hale getirir veya normalize eder
|
||||
- `createStreamFn`: sağlayıcı, normal akış yolunu tamamen özel bir
|
||||
taşıma ile değiştirir
|
||||
- `wrapStreamFn`: sağlayıcı, istek üstbilgisi/gövdesi/model uyumluluk sarmalayıcıları uygular
|
||||
- `resolveTransportTurnState`: sağlayıcı, tur başına doğal taşıma
|
||||
- `resolveTransportTurnState`: sağlayıcı, tur başına yerel taşıma
|
||||
üstbilgileri veya meta verileri sağlar
|
||||
- `resolveWebSocketSessionPolicy`: sağlayıcı, doğal WebSocket oturumu
|
||||
üstbilgileri veya oturum bekleme politikası sağlar
|
||||
- `createEmbeddingProvider`: sağlayıcı, çekirdek embedding yönlendirme panosu yerine sağlayıcı eklentisine ait olduğunda
|
||||
bellek embedding davranışına sahip olur
|
||||
- `formatApiKey`: sağlayıcı, depolanan kimlik doğrulama profillerini taşımanın beklediği çalışma zamanı
|
||||
`apiKey` dizesine dönüştürür
|
||||
- `refreshOAuth`: paylaşılan `pi-ai`
|
||||
yenileyicileri yeterli olmadığında OAuth yenilemesine sağlayıcı sahip olur
|
||||
- `buildAuthDoctorHint`: OAuth yenilemesi
|
||||
başarısız olduğunda sağlayıcı onarım rehberi ekler
|
||||
- `matchesContextOverflowError`: sağlayıcı, genel sezgilerin gözden kaçıracağı
|
||||
- `resolveWebSocketSessionPolicy`: sağlayıcı, yerel WebSocket oturumu
|
||||
üstbilgileri veya oturum cooldown ilkesini sağlar
|
||||
- `createEmbeddingProvider`: sağlayıcı, bellek embedding davranışını sahiplenir; bu davranış
|
||||
çekirdek embedding anahtarlama mantığı yerine provider Plugin'i ile birlikte olmalıdır
|
||||
- `formatApiKey`: sağlayıcı, depolanan kimlik doğrulama profillerini çalışma zamanının
|
||||
beklediği `apiKey` dizgesine biçimlendirir
|
||||
- `refreshOAuth`: sağlayıcı, paylaşılan `pi-ai`
|
||||
yenileyicileri yeterli olmadığında OAuth yenilemeyi sahiplenir
|
||||
- `buildAuthDoctorHint`: sağlayıcı, OAuth yenileme
|
||||
başarısız olduğunda onarım rehberliği ekler
|
||||
- `matchesContextOverflowError`: sağlayıcı, genel sezgilerin kaçıracağı
|
||||
sağlayıcıya özgü bağlam penceresi taşma hatalarını tanır
|
||||
- `classifyFailoverReason`: sağlayıcı, sağlayıcıya özgü ham taşıma/API
|
||||
hatalarını oran sınırı veya aşırı yük gibi geri dönüş nedenlerine eşler
|
||||
- `isCacheTtlEligible`: sağlayıcı, hangi üst akış model kimliklerinin istem önbelleği TTL'sini desteklediğine karar verir
|
||||
- `buildMissingAuthMessage`: sağlayıcı, genel kimlik doğrulama deposu hatasını
|
||||
hatalarını hız sınırı veya aşırı yük gibi failover nedenlerine eşler
|
||||
- `isCacheTtlEligible`: sağlayıcı, hangi upstream model kimliklerinin prompt-cache TTL'yi desteklediğine karar verir
|
||||
- `buildMissingAuthMessage`: sağlayıcı, genel auth-store hatasını
|
||||
sağlayıcıya özgü bir kurtarma ipucuyla değiştirir
|
||||
- `suppressBuiltInModel`: sağlayıcı, eski üst akış satırlarını gizler ve
|
||||
- `suppressBuiltInModel`: sağlayıcı, eski upstream satırlarını gizler ve
|
||||
doğrudan çözümleme başarısızlıkları için satıcıya ait bir hata döndürebilir
|
||||
- `augmentModelCatalog`: sağlayıcı, keşif ve yapılandırma birleştirmesinden sonra
|
||||
sentetik/nihai katalog satırları ekler
|
||||
- `isBinaryThinking`: sağlayıcı, ikili açık/kapalı düşünme deneyimine sahip olur
|
||||
- `supportsXHighThinking`: sağlayıcı, seçili modelleri `xhigh` için etkinleştirir
|
||||
- `resolveDefaultThinkingLevel`: sağlayıcı, bir
|
||||
model ailesi için varsayılan `/think` politikasına sahip olur
|
||||
- `isBinaryThinking`: sağlayıcı, ikili aç/kapat düşünme UX'ini sahiplenir
|
||||
- `supportsXHighThinking`: sağlayıcı, seçilen modelleri `xhigh` için etkinleştirir
|
||||
- `resolveDefaultThinkingLevel`: sağlayıcı, bir model ailesi için varsayılan `/think` ilkesini sahiplenir
|
||||
- `applyConfigDefaults`: sağlayıcı, kimlik doğrulama modu, env veya model ailesine göre
|
||||
yapılandırma somutlaştırması sırasında sağlayıcıya özgü genel varsayılanları uygular
|
||||
- `isModernModelRef`: sağlayıcı, canlı/smoke tercih edilen model eşleşmesine sahip olur
|
||||
- `isModernModelRef`: sağlayıcı, canlı/smoke tercih edilen model eşlemesini sahiplenir
|
||||
- `prepareRuntimeAuth`: sağlayıcı, yapılandırılmış bir kimlik bilgisini kısa ömürlü
|
||||
bir çalışma zamanı belirtecine dönüştürür
|
||||
- `resolveUsageAuth`: sağlayıcı, `/usage`
|
||||
ve ilgili durum/raporlama yüzeyleri için kullanım/kota kimlik bilgilerini çözümler
|
||||
- `fetchUsageSnapshot`: sağlayıcı, kullanım uç noktası getirme/ayrıştırmasına sahip olurken
|
||||
çekirdek yine de özet kabuğuna ve biçimlendirmeye sahip olur
|
||||
- `resolveUsageAuth`: sağlayıcı, `/usage` ve ilgili durum/raporlama yüzeyleri için
|
||||
kullanım/kota kimlik bilgilerini çözer
|
||||
- `fetchUsageSnapshot`: sağlayıcı, kullanım uç noktası getirme/ayrıştırmasını sahiplenirken
|
||||
çekirdek yine özet kabuğu ve biçimlendirmeyi sahiplenir
|
||||
- `onModelSelected`: sağlayıcı, telemetri veya sağlayıcıya ait oturum kayıtları gibi
|
||||
seçim sonrası yan etkilere sahip olur
|
||||
model seçimi sonrası yan etkileri çalıştırır
|
||||
|
||||
Mevcut paketlenmiş örnekler:
|
||||
|
||||
- `anthropic`: Claude 4.6 ileri uyumluluk geri dönüşü, kimlik doğrulama onarım ipuçları, kullanım
|
||||
uç noktası getirme, cache-TTL/sağlayıcı ailesi meta verisi ve kimlik doğrulamaya duyarlı genel
|
||||
uç noktası getirme, cache-TTL/sağlayıcı ailesi meta verisi ve kimlik doğrulama farkındalıklı genel
|
||||
yapılandırma varsayılanları
|
||||
- `amazon-bedrock`: Bedrock'a özgü boğma/hazır değil hataları için sağlayıcıya ait bağlam taşması eşleştirme ve geri dönüş
|
||||
nedeni sınıflandırması; ayrıca Anthropic trafiğinde yalnızca Claude geri oynatma ilkesi
|
||||
korumaları için paylaşılan `anthropic-by-model` yeniden oynatma ailesi
|
||||
- `amazon-bedrock`: Bedrock'a özgü throttle/hazır değil hataları için sağlayıcıya ait bağlam taşması eşleştirmesi ve failover
|
||||
nedeni sınıflandırması; ayrıca Anthropic trafiğinde yalnızca Claude için replay-policy
|
||||
korumaları sağlayan paylaşılan `anthropic-by-model` replay ailesi
|
||||
- `anthropic-vertex`: Anthropic-message
|
||||
trafiğinde yalnızca Claude geri oynatma ilkesi korumaları
|
||||
- `openrouter`: doğrudan geçen model kimlikleri, istek sarmalayıcıları, sağlayıcı yetenek
|
||||
ipuçları, proxy Gemini trafiğinde Gemini thought-signature temizleme, `openrouter-thinking` akış ailesi üzerinden proxy
|
||||
akıl yürütme ekleme, yönlendirme meta verisi iletimi ve cache-TTL ilkesi
|
||||
- `github-copilot`: katılım/cihaz oturum açma, ileri uyumluluk model geri dönüşü,
|
||||
Claude düşünme döküm ipuçları, çalışma zamanı belirteç değişimi ve kullanım uç noktası
|
||||
trafiğinde yalnızca Claude için replay-policy korumaları
|
||||
- `openrouter`: doğrudan aktarılan model kimlikleri, istek sarmalayıcıları, sağlayıcı yetenek
|
||||
ipuçları, proxy Gemini trafiğinde Gemini thought-signature temizleme, `openrouter-thinking` akış ailesi üzerinden
|
||||
proxy muhakeme ekleme, yönlendirme meta verisi iletimi ve cache-TTL ilkesi
|
||||
- `github-copilot`: onboarding/cihaz girişi, ileri uyumluluk model geri dönüşü,
|
||||
Claude-thinking transkript ipuçları, çalışma zamanı belirteç değişimi ve kullanım uç noktası
|
||||
getirme
|
||||
- `openai`: GPT-5.4 ileri uyumluluk geri dönüşü, doğrudan OpenAI taşıma
|
||||
normalleştirmesi, Codex farkındalıklı eksik kimlik doğrulama ipuçları, Spark bastırma, sentetik
|
||||
OpenAI/Codex katalog satırları, düşünme/canlı model ilkesi, kullanım belirteci takma ad
|
||||
normalleştirmesi (`input` / `output` ve `prompt` / `completion` aileleri), doğal OpenAI/Codex
|
||||
OpenAI/Codex katalog satırları, thinking/canlı model ilkesi, kullanım belirteci takma ad
|
||||
normalleştirmesi (`input` / `output` ve `prompt` / `completion` aileleri), yerel OpenAI/Codex
|
||||
sarmalayıcıları için paylaşılan `openai-responses-defaults` akış ailesi, sağlayıcı ailesi meta verisi, paketlenmiş görsel oluşturma sağlayıcısı
|
||||
kaydı `gpt-image-1` için ve paketlenmiş video oluşturma sağlayıcısı
|
||||
kaydı `sora-2` için
|
||||
kaydı (`gpt-image-1` için) ve paketlenmiş video oluşturma sağlayıcısı
|
||||
kaydı (`sora-2` için)
|
||||
- `google` ve `google-gemini-cli`: Gemini 3.1 ileri uyumluluk geri dönüşü,
|
||||
doğal Gemini yeniden oynatma doğrulaması, bootstrap yeniden oynatma temizleme, etiketli
|
||||
akıl yürütme çıktısı modu, modern model eşleştirme, Gemini image-preview modelleri için paketlenmiş görsel oluşturma
|
||||
yerel Gemini replay doğrulaması, bootstrap replay temizleme, etiketli
|
||||
muhakeme çıktısı modu, modern model eşleştirmesi, Gemini image-preview modelleri için paketlenmiş görsel oluşturma
|
||||
sağlayıcısı kaydı ve Veo modelleri için paketlenmiş
|
||||
video oluşturma sağlayıcısı kaydı; ayrıca Gemini CLI OAuth,
|
||||
kullanım yüzeyleri için kimlik doğrulama profili belirteç biçimlendirmesine, kullanım belirteci ayrıştırmasına ve kota uç noktası
|
||||
getirmesine de sahiptir
|
||||
- `moonshot`: paylaşılan taşıma, eklentiye ait düşünme yükü normalleştirmesi
|
||||
- `kilocode`: paylaşılan taşıma, eklentiye ait istek üstbilgileri, akıl yürütme yükü
|
||||
video oluşturma sağlayıcısı kaydı; Gemini CLI OAuth ayrıca
|
||||
kullanım yüzeyleri için kimlik doğrulama profili belirteç biçimlendirmesi, kullanım belirteci ayrıştırması ve kota uç noktası
|
||||
getirmesini de sahiplenir
|
||||
- `moonshot`: paylaşılan taşıma, Plugin'e ait thinking payload normalleştirmesi
|
||||
- `kilocode`: paylaşılan taşıma, Plugin'e ait istek üstbilgileri, muhakeme payload
|
||||
normalleştirmesi, proxy-Gemini thought-signature temizleme ve cache-TTL
|
||||
ilkesi
|
||||
- `zai`: GLM-5 ileri uyumluluk geri dönüşü, `tool_stream` varsayılanları, cache-TTL
|
||||
ilkesi, ikili düşünme/canlı model ilkesi ve kullanım kimlik doğrulaması + kota getirme;
|
||||
bilinmeyen `glm-5*` kimlikleri paketlenmiş `glm-4.7` şablonundan sentetik olarak oluşturulur
|
||||
- `xai`: doğal Responses taşıma normalleştirmesi, Grok hızlı varyantları için `/fast` takma ad yeniden yazımları,
|
||||
varsayılan `tool_stream`, xAI'ye özgü araç şeması /
|
||||
akıl yürütme yükü temizliği ve `grok-imagine-video` için paketlenmiş video oluşturma sağlayıcısı
|
||||
ilkesi, ikili thinking/canlı model ilkesi ve kullanım kimlik doğrulaması + kota getirme;
|
||||
bilinmeyen `glm-5*` kimlikleri paketlenmiş `glm-4.7` şablonundan sentezlenir
|
||||
- `xai`: yerel Responses taşıma normalleştirmesi, Grok hızlı varyantları için
|
||||
`/fast` takma ad yeniden yazımları, varsayılan `tool_stream`, xAI'ye özgü araç şeması /
|
||||
muhakeme payload temizleme ve `grok-imagine-video` için paketlenmiş video oluşturma sağlayıcısı
|
||||
kaydı
|
||||
- `mistral`: eklentiye ait yetenek meta verisi
|
||||
- `opencode` ve `opencode-go`: eklentiye ait yetenek meta verisi ve ayrıca
|
||||
- `mistral`: Plugin'e ait yetenek meta verisi
|
||||
- `opencode` ve `opencode-go`: Plugin'e ait yetenek meta verisi ve ayrıca
|
||||
proxy-Gemini thought-signature temizleme
|
||||
- `alibaba`: `alibaba/wan2.6-t2v` gibi doğrudan Wan model başvuruları için eklentiye ait video oluşturma kataloğu
|
||||
- `byteplus`: eklentiye ait kataloglar ve ayrıca Seedance metinden videoya/görselden videoya modelleri için paketlenmiş video oluşturma sağlayıcısı
|
||||
- `alibaba`: `alibaba/wan2.6-t2v` gibi doğrudan Wan model başvuruları için
|
||||
Plugin'e ait video oluşturma kataloğu
|
||||
- `byteplus`: Plugin'e ait kataloglar ve ayrıca Seedance metinden videoya/görselden videoya modelleri için paketlenmiş video oluşturma sağlayıcısı
|
||||
kaydı
|
||||
- `fal`: barındırılan üçüncü taraf görüntü modelleri için paketlenmiş görsel oluşturma sağlayıcısı
|
||||
kaydı ve ayrıca barındırılan üçüncü taraf video modelleri için paketlenmiş
|
||||
video oluşturma sağlayıcısı kaydı
|
||||
- `fal`: barındırılan üçüncü taraf video modelleri için paketlenmiş video oluşturma sağlayıcısı
|
||||
kaydı ve ayrıca FLUX görsel modelleri için görsel oluşturma sağlayıcısı kaydı ile birlikte
|
||||
barındırılan üçüncü taraf video modelleri için paketlenmiş video oluşturma sağlayıcısı kaydı
|
||||
- `cloudflare-ai-gateway`, `huggingface`, `kimi`, `nvidia`, `qianfan`,
|
||||
`stepfun`, `synthetic`, `venice`, `vercel-ai-gateway` ve `volcengine`:
|
||||
yalnızca eklentiye ait kataloglar
|
||||
- `qwen`: metin modelleri için eklentiye ait kataloglar ve ayrıca
|
||||
çok kipli yüzeyleri için paylaşılan media-understanding ve video oluşturma sağlayıcısı kayıtları;
|
||||
Qwen video oluşturma, `wan2.6-t2v` ve `wan2.7-r2v` gibi paketlenmiş Wan modelleriyle Standard DashScope video
|
||||
uç noktalarını kullanır
|
||||
- `runway`: `gen4.5` gibi doğal
|
||||
Runway görev tabanlı modeller için eklentiye ait video oluşturma sağlayıcısı kaydı
|
||||
- `minimax`: eklentiye ait kataloglar, Hailuo video modelleri için paketlenmiş video oluşturma sağlayıcısı
|
||||
yalnızca Plugin'e ait kataloglar
|
||||
- `qwen`: metin modelleri için Plugin'e ait kataloglar ve ayrıca
|
||||
çok modlu yüzeyleri için paylaşılan media-understanding ve video oluşturma sağlayıcısı kayıtları;
|
||||
Qwen video oluşturma, `wan2.6-t2v` ve `wan2.7-r2v` gibi paketlenmiş Wan modelleriyle
|
||||
standart DashScope video uç noktalarını kullanır
|
||||
- `runway`: `gen4.5` gibi yerel
|
||||
Runway görev tabanlı modelleri için Plugin'e ait video oluşturma sağlayıcısı kaydı
|
||||
- `minimax`: Plugin'e ait kataloglar, Hailuo video modelleri için paketlenmiş video oluşturma sağlayıcısı
|
||||
kaydı, `image-01` için paketlenmiş görsel oluşturma sağlayıcısı
|
||||
kaydı, hibrit Anthropic/OpenAI yeniden oynatma ilkesi
|
||||
kaydı, hibrit Anthropic/OpenAI replay-policy
|
||||
seçimi ve kullanım kimlik doğrulaması/anlık görüntü mantığı
|
||||
- `together`: eklentiye ait kataloglar ve ayrıca Wan video modelleri için paketlenmiş video oluşturma sağlayıcısı
|
||||
- `together`: Plugin'e ait kataloglar ve ayrıca Wan video modelleri için paketlenmiş video oluşturma sağlayıcısı
|
||||
kaydı
|
||||
- `xiaomi`: eklentiye ait kataloglar ve ayrıca kullanım kimlik doğrulaması/anlık görüntü mantığı
|
||||
- `xiaomi`: Plugin'e ait kataloglar ve ayrıca kullanım kimlik doğrulaması/anlık görüntü mantığı
|
||||
|
||||
Paketlenmiş `openai` eklentisi artık her iki sağlayıcı kimliğine de sahiptir: `openai` ve
|
||||
Paketlenmiş `openai` Plugin'i artık her iki sağlayıcı kimliğini de sahipleniyor: `openai` ve
|
||||
`openai-codex`.
|
||||
|
||||
Bu, hâlâ OpenClaw'ın normal taşımalarına uyan sağlayıcıları kapsar. Tamamen
|
||||
özel bir istek yürütücüsüne ihtiyaç duyan bir sağlayıcı ise ayrı, daha derin bir genişletme yüzeyidir.
|
||||
Bu, hâlâ OpenClaw'ın normal taşımalarına uyan sağlayıcıları kapsar. Tamamen özel bir istek yürütücüsüne ihtiyaç duyan bir sağlayıcı
|
||||
ayrı ve daha derin bir genişletme yüzeyidir.
|
||||
|
||||
## API anahtarı rotasyonu
|
||||
|
||||
- Seçili sağlayıcılar için genel sağlayıcı rotasyonunu destekler.
|
||||
- Birden fazla anahtarı şununla yapılandırın:
|
||||
- Birden çok anahtarı şu yollarla yapılandırın:
|
||||
- `OPENCLAW_LIVE_<PROVIDER>_KEY` (tek canlı geçersiz kılma, en yüksek öncelik)
|
||||
- `<PROVIDER>_API_KEYS` (virgül veya noktalı virgülle ayrılmış liste)
|
||||
- `<PROVIDER>_API_KEY` (birincil anahtar)
|
||||
- `<PROVIDER>_API_KEY_*` (numaralandırılmış liste, ör. `<PROVIDER>_API_KEY_1`)
|
||||
- Google sağlayıcıları için `GOOGLE_API_KEY` da geri dönüş olarak dahil edilir.
|
||||
- Anahtar seçim sırası önceliği korur ve değerlerin tekrarını kaldırır.
|
||||
- İstekler yalnızca oran sınırı yanıtlarında bir sonraki anahtarla yeniden denenir (
|
||||
- Google sağlayıcıları için `GOOGLE_API_KEY` de geri dönüş olarak dahil edilir.
|
||||
- Anahtar seçim sırası önceliği korur ve değerleri tekilleştirir.
|
||||
- İstekler yalnızca hız sınırı yanıtlarında bir sonraki anahtarla yeniden denenir (
|
||||
örneğin `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many
|
||||
concurrent requests`, `ThrottlingException`, `concurrency limit reached`,
|
||||
`workers_ai ... quota limit exceeded` veya dönemsel kullanım sınırı mesajları).
|
||||
- Oran sınırı dışındaki hatalar hemen başarısız olur; anahtar rotasyonu denenmez.
|
||||
`workers_ai ... quota limit exceeded` veya dönemsel kullanım sınırı iletileri).
|
||||
- Hız sınırı dışındaki hatalar hemen başarısız olur; anahtar rotasyonu denenmez.
|
||||
- Tüm aday anahtarlar başarısız olduğunda, son hata son denemeden döndürülür.
|
||||
|
||||
## Yerleşik sağlayıcılar (pi-ai kataloğu)
|
||||
@ -248,21 +252,21 @@ OpenClaw, pi‑ai kataloğuyla birlikte gelir. Bu sağlayıcılar için **hiç**
|
||||
|
||||
- Sağlayıcı: `openai`
|
||||
- Kimlik doğrulama: `OPENAI_API_KEY`
|
||||
- İsteğe bağlı rotasyon: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2` ve ayrıca `OPENCLAW_LIVE_OPENAI_KEY` (tek geçersiz kılma)
|
||||
- İsteğe bağlı rotasyon: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2`, ayrıca `OPENCLAW_LIVE_OPENAI_KEY` (tek geçersiz kılma)
|
||||
- Örnek modeller: `openai/gpt-5.4`, `openai/gpt-5.4-pro`
|
||||
- CLI: `openclaw onboard --auth-choice openai-api-key`
|
||||
- Varsayılan taşıma `auto`'dur (`WebSocket` önce, `SSE` geri dönüş)
|
||||
- Model başına şununla geçersiz kılın: `agents.defaults.models["openai/<model>"].params.transport` (`"sse"`, `"websocket"` veya `"auto"`)
|
||||
- OpenAI Responses WebSocket ısındırma varsayılan olarak `params.openaiWsWarmup` (`true`/`false`) ile etkindir
|
||||
- OpenAI öncelikli işleme, `agents.defaults.models["openai/<model>"].params.serviceTier` ile etkinleştirilebilir
|
||||
- Varsayılan taşıma `auto`'dur (önce WebSocket, sonra SSE geri dönüşü)
|
||||
- Model başına geçersiz kılmak için `agents.defaults.models["openai/<model>"].params.transport` kullanın (`"sse"`, `"websocket"` veya `"auto"`)
|
||||
- OpenAI Responses WebSocket ön ısıtma varsayılan olarak `params.openaiWsWarmup` üzerinden etkindir (`true`/`false`)
|
||||
- OpenAI öncelikli işleme `agents.defaults.models["openai/<model>"].params.serviceTier` ile etkinleştirilebilir
|
||||
- `/fast` ve `params.fastMode`, doğrudan `openai/*` Responses isteklerini `api.openai.com` üzerinde `service_tier=priority` değerine eşler
|
||||
- Paylaşılan `/fast` anahtarı yerine açık bir katman istediğinizde `params.serviceTier` kullanın
|
||||
- Paylaşılan `/fast` geçişi yerine açık bir katman istediğinizde `params.serviceTier` kullanın
|
||||
- Gizli OpenClaw atıf üstbilgileri (`originator`, `version`,
|
||||
`User-Agent`) yalnızca `api.openai.com` adresine giden doğal OpenAI trafiğinde uygulanır,
|
||||
`User-Agent`) yalnızca `api.openai.com` adresine giden yerel OpenAI trafiğinde uygulanır,
|
||||
genel OpenAI uyumlu proxy'lerde uygulanmaz
|
||||
- Doğal OpenAI yolları ayrıca Responses `store`, istem önbelleği ipuçları ve
|
||||
OpenAI akıl yürütme uyumluluğu yük şekillendirmesini korur; proxy yolları bunu korumaz
|
||||
- `openai/gpt-5.3-codex-spark`, canlı OpenAI API bunu reddettiği için OpenClaw'da kasıtlı olarak bastırılmıştır; Spark yalnızca Codex olarak değerlendirilir
|
||||
- Yerel OpenAI yolları ayrıca Responses `store`, prompt-cache ipuçları ve
|
||||
OpenAI reasoning-compat payload şekillendirmesini korur; proxy yolları korumaz
|
||||
- `openai/gpt-5.3-codex-spark`, canlı OpenAI API'si bunu reddettiği için OpenClaw'da bilerek bastırılır; Spark yalnızca Codex'e özgü kabul edilir
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -274,12 +278,12 @@ OpenClaw, pi‑ai kataloğuyla birlikte gelir. Bu sağlayıcılar için **hiç**
|
||||
|
||||
- Sağlayıcı: `anthropic`
|
||||
- Kimlik doğrulama: `ANTHROPIC_API_KEY`
|
||||
- İsteğe bağlı rotasyon: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2` ve ayrıca `OPENCLAW_LIVE_ANTHROPIC_KEY` (tek geçersiz kılma)
|
||||
- İsteğe bağlı rotasyon: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, ayrıca `OPENCLAW_LIVE_ANTHROPIC_KEY` (tek geçersiz kılma)
|
||||
- Örnek model: `anthropic/claude-opus-4-6`
|
||||
- CLI: `openclaw onboard --auth-choice apiKey`
|
||||
- Doğrudan genel Anthropic istekleri, `api.anthropic.com` adresine gönderilen API anahtarı ve OAuth kimlik doğrulamalı trafik dahil olmak üzere, paylaşılan `/fast` anahtarını ve `params.fastMode` seçeneğini de destekler; OpenClaw bunu Anthropic `service_tier` değerine (`auto` ve `standard_only`) eşler
|
||||
- Anthropic notu: Anthropic personeli bize OpenClaw tarzı Claude CLI kullanımına tekrar izin verildiğini söyledi, bu nedenle Anthropic yeni bir ilke yayımlamadıkça OpenClaw bu entegrasyon için Claude CLI yeniden kullanımını ve `claude -p` kullanımını izinli kabul eder.
|
||||
- Anthropic kurulum belirteci, desteklenen bir OpenClaw belirteç yolu olarak kullanılmaya devam eder, ancak OpenClaw artık mümkün olduğunda Claude CLI yeniden kullanımını ve `claude -p` kullanımını tercih eder.
|
||||
- Doğrudan genel Anthropic istekleri, `api.anthropic.com` adresine gönderilen API anahtarıyla ve OAuth ile kimliği doğrulanmış trafikte dahil olmak üzere, paylaşılan `/fast` geçişini ve `params.fastMode` değerini de destekler; OpenClaw bunu Anthropic `service_tier` değerine eşler (`auto` ve `standard_only`)
|
||||
- Anthropic notu: Anthropic çalışanları bize OpenClaw tarzı Claude CLI kullanımına tekrar izin verildiğini söyledi, bu nedenle Anthropic yeni bir ilke yayımlamadıkça OpenClaw, Claude CLI yeniden kullanımını ve `claude -p` kullanımını bu entegrasyon için onaylı kabul eder.
|
||||
- Anthropic setup-token desteklenen bir OpenClaw belirteç yolu olarak kullanılmaya devam eder, ancak OpenClaw artık mümkün olduğunda Claude CLI yeniden kullanımını ve `claude -p` yolunu tercih eder.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -293,16 +297,16 @@ OpenClaw, pi‑ai kataloğuyla birlikte gelir. Bu sağlayıcılar için **hiç**
|
||||
- Kimlik doğrulama: OAuth (ChatGPT)
|
||||
- Örnek model: `openai-codex/gpt-5.4`
|
||||
- CLI: `openclaw onboard --auth-choice openai-codex` veya `openclaw models auth login --provider openai-codex`
|
||||
- Varsayılan taşıma `auto`'dur (`WebSocket` önce, `SSE` geri dönüş)
|
||||
- Model başına şununla geçersiz kılın: `agents.defaults.models["openai-codex/<model>"].params.transport` (`"sse"`, `"websocket"` veya `"auto"`)
|
||||
- `params.serviceTier` doğal Codex Responses isteklerinde de iletilir (`chatgpt.com/backend-api`)
|
||||
- Varsayılan taşıma `auto`'dur (önce WebSocket, sonra SSE geri dönüşü)
|
||||
- Model başına geçersiz kılmak için `agents.defaults.models["openai-codex/<model>"].params.transport` kullanın (`"sse"`, `"websocket"` veya `"auto"`)
|
||||
- `params.serviceTier` yerel Codex Responses isteklerinde de iletilir (`chatgpt.com/backend-api`)
|
||||
- Gizli OpenClaw atıf üstbilgileri (`originator`, `version`,
|
||||
`User-Agent`) yalnızca `chatgpt.com/backend-api` adresine giden doğal Codex trafiğinde
|
||||
`User-Agent`) yalnızca `chatgpt.com/backend-api` adresine giden yerel Codex trafiğinde
|
||||
eklenir, genel OpenAI uyumlu proxy'lerde eklenmez
|
||||
- Doğrudan `openai/*` ile aynı `/fast` anahtarını ve `params.fastMode` yapılandırmasını paylaşır; OpenClaw bunu `service_tier=priority` değerine eşler
|
||||
- `openai-codex/gpt-5.3-codex-spark`, Codex OAuth kataloğu bunu sunduğunda kullanılabilir olmaya devam eder; yetki haklarına bağlıdır
|
||||
- `openai-codex/gpt-5.4`, doğal `contextWindow = 1050000` ve varsayılan çalışma zamanı `contextTokens = 272000` değerlerini korur; çalışma zamanı sınırını `models.providers.openai-codex.models[].contextTokens` ile geçersiz kılın
|
||||
- İlke notu: OpenAI Codex OAuth, OpenClaw gibi harici araçlar/iş akışları için açıkça desteklenmektedir.
|
||||
- Doğrudan `openai/*` ile aynı `/fast` geçişini ve `params.fastMode` yapılandırmasını paylaşır; OpenClaw bunu `service_tier=priority` değerine eşler
|
||||
- `openai-codex/gpt-5.3-codex-spark`, Codex OAuth kataloğu bunu gösterdiğinde kullanılabilir olmaya devam eder; yetkiye bağlıdır
|
||||
- `openai-codex/gpt-5.4`, yerel `contextWindow = 1050000` ve varsayılan çalışma zamanı `contextTokens = 272000` değerlerini korur; çalışma zamanı sınırını `models.providers.openai-codex.models[].contextTokens` ile geçersiz kılın
|
||||
- İlke notu: OpenAI Codex OAuth, OpenClaw gibi harici araçlar/iş akışları için açıkça desteklenir.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -324,7 +328,7 @@ OpenClaw, pi‑ai kataloğuyla birlikte gelir. Bu sağlayıcılar için **hiç**
|
||||
|
||||
### Diğer abonelik tarzı barındırılan seçenekler
|
||||
|
||||
- [Qwen Cloud](/tr/providers/qwen): Qwen Cloud sağlayıcı yüzeyi ve ayrıca Alibaba DashScope ile Coding Plan uç noktası eşlemesi
|
||||
- [Qwen Cloud](/tr/providers/qwen): Qwen Cloud sağlayıcı yüzeyi ve ayrıca Alibaba DashScope ile Coding Plan uç nokta eşlemesi
|
||||
- [MiniMax](/tr/providers/minimax): MiniMax Coding Plan OAuth veya API anahtarı erişimi
|
||||
- [GLM Models](/tr/providers/glm): Z.AI Coding Plan veya genel API uç noktaları
|
||||
|
||||
@ -348,29 +352,29 @@ OpenClaw, pi‑ai kataloğuyla birlikte gelir. Bu sağlayıcılar için **hiç**
|
||||
- Kimlik doğrulama: `GEMINI_API_KEY`
|
||||
- İsteğe bağlı rotasyon: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, `GOOGLE_API_KEY` geri dönüşü ve `OPENCLAW_LIVE_GEMINI_KEY` (tek geçersiz kılma)
|
||||
- Örnek modeller: `google/gemini-3.1-pro-preview`, `google/gemini-3-flash-preview`
|
||||
- Uyumluluk: `google/gemini-3.1-flash-preview` kullanan eski OpenClaw yapılandırması `google/gemini-3-flash-preview` olarak normalleştirilir
|
||||
- Uyumluluk: `google/gemini-3.1-flash-preview` kullanan eski OpenClaw yapılandırması `google/gemini-3-flash-preview` olarak normalize edilir
|
||||
- CLI: `openclaw onboard --auth-choice gemini-api-key`
|
||||
- Doğrudan Gemini çalıştırmaları ayrıca `agents.defaults.models["google/<model>"].params.cachedContent`
|
||||
(veya eski `cached_content`) seçeneğini de kabul eder; bu, sağlayıcıya özgü
|
||||
bir `cachedContents/...` tanıtıcısını iletmek içindir; Gemini önbellek isabetleri OpenClaw `cacheRead` olarak görünür
|
||||
- Doğrudan Gemini çalıştırmaları ayrıca sağlayıcıya özgü yerel bir
|
||||
`cachedContents/...` tanıtıcısını iletmek için `agents.defaults.models["google/<model>"].params.cachedContent`
|
||||
(veya eski `cached_content`) kabul eder; Gemini önbellek isabetleri OpenClaw `cacheRead` olarak görünür
|
||||
|
||||
### Google Vertex ve Gemini CLI
|
||||
|
||||
- Sağlayıcılar: `google-vertex`, `google-gemini-cli`
|
||||
- Kimlik doğrulama: Vertex, gcloud ADC kullanır; Gemini CLI ise kendi OAuth akışını kullanır
|
||||
- Dikkat: OpenClaw içindeki Gemini CLI OAuth, resmi olmayan bir entegrasyondur. Bazı kullanıcılar üçüncü taraf istemcileri kullandıktan sonra Google hesaplarında kısıtlamalar bildirmiştir. Devam etmeyi seçerseniz Google şartlarını gözden geçirin ve kritik olmayan bir hesap kullanın.
|
||||
- Gemini CLI OAuth, paketlenmiş `google` eklentisinin bir parçası olarak sunulur.
|
||||
- Dikkat: OpenClaw içindeki Gemini CLI OAuth resmi olmayan bir entegrasyondur. Bazı kullanıcılar, üçüncü taraf istemcileri kullandıktan sonra Google hesaplarında kısıtlamalar bildirildiğini belirtti. İlerlemeyi seçerseniz Google şartlarını gözden geçirin ve kritik olmayan bir hesap kullanın.
|
||||
- Gemini CLI OAuth, paketlenmiş `google` Plugin'inin bir parçası olarak sunulur.
|
||||
- Önce Gemini CLI'yi yükleyin:
|
||||
- `brew install gemini-cli`
|
||||
- veya `npm install -g @google/gemini-cli`
|
||||
- Etkinleştirin: `openclaw plugins enable google`
|
||||
- Oturum açın: `openclaw models auth login --provider google-gemini-cli --set-default`
|
||||
- Giriş yapın: `openclaw models auth login --provider google-gemini-cli --set-default`
|
||||
- Varsayılan model: `google-gemini-cli/gemini-3-flash-preview`
|
||||
- Not: bir istemci kimliği veya gizli anahtarı `openclaw.json` içine **yapıştırmazsınız**. CLI oturum açma akışı,
|
||||
belirteçleri ağ geçidi ana makinesindeki kimlik doğrulama profillerinde depolar.
|
||||
- Oturum açtıktan sonra istekler başarısız olursa, ağ geçidi ana makinesinde `GOOGLE_CLOUD_PROJECT` veya `GOOGLE_CLOUD_PROJECT_ID` ayarlayın.
|
||||
- Gemini CLI JSON yanıtları `response` içinden ayrıştırılır; kullanım için geri dönüş olarak
|
||||
`stats` kullanılır ve `stats.cached`, OpenClaw `cacheRead` olarak normalleştirilir.
|
||||
- Not: `openclaw.json` içine bir istemci kimliği veya gizli anahtar yapıştırmazsınız. CLI giriş akışı,
|
||||
belirteçleri Gateway ana makinesindeki auth profillerinde depolar.
|
||||
- Girişten sonra istekler başarısız olursa, Gateway ana makinesinde `GOOGLE_CLOUD_PROJECT` veya `GOOGLE_CLOUD_PROJECT_ID` ayarlayın.
|
||||
- Gemini CLI JSON yanıtları `response` alanından ayrıştırılır; kullanım bilgisi
|
||||
`stats` alanına geri döner ve `stats.cached`, OpenClaw `cacheRead` olarak normalize edilir.
|
||||
|
||||
### Z.AI (GLM)
|
||||
|
||||
@ -378,8 +382,8 @@ OpenClaw, pi‑ai kataloğuyla birlikte gelir. Bu sağlayıcılar için **hiç**
|
||||
- Kimlik doğrulama: `ZAI_API_KEY`
|
||||
- Örnek model: `zai/glm-5.1`
|
||||
- CLI: `openclaw onboard --auth-choice zai-api-key`
|
||||
- Takma adlar: `z.ai/*` ve `z-ai/*`, `zai/*` olarak normalleştirilir
|
||||
- `zai-api-key`, eşleşen Z.AI uç noktasını otomatik algılar; `zai-coding-global`, `zai-coding-cn`, `zai-global` ve `zai-cn` ise belirli bir yüzeyi zorlar
|
||||
- Takma adlar: `z.ai/*` ve `z-ai/*`, `zai/*` olarak normalize edilir
|
||||
- `zai-api-key`, eşleşen Z.AI uç noktasını otomatik algılar; `zai-coding-global`, `zai-coding-cn`, `zai-global` ve `zai-cn` belirli bir yüzeyi zorlar
|
||||
|
||||
### Vercel AI Gateway
|
||||
|
||||
@ -395,37 +399,37 @@ OpenClaw, pi‑ai kataloğuyla birlikte gelir. Bu sağlayıcılar için **hiç**
|
||||
- Örnek model: `kilocode/kilo/auto`
|
||||
- CLI: `openclaw onboard --auth-choice kilocode-api-key`
|
||||
- Temel URL: `https://api.kilo.ai/api/gateway/`
|
||||
- Statik geri dönüş kataloğu `kilocode/kilo/auto` ile gelir; canlı
|
||||
`https://api.kilo.ai/api/gateway/models` keşfi, çalışma zamanı
|
||||
- Statik geri dönüş kataloğu `kilocode/kilo/auto` ile birlikte gelir; canlı
|
||||
`https://api.kilo.ai/api/gateway/models` keşfi çalışma zamanı
|
||||
kataloğunu daha da genişletebilir.
|
||||
- `kilocode/kilo/auto` arkasındaki tam üst akış yönlendirmesi, OpenClaw içinde sabit kodlanmış değildir;
|
||||
bunun sahibi Kilo Gateway'dir.
|
||||
- `kilocode/kilo/auto` arkasındaki tam upstream yönlendirme Kilo Gateway'e aittir,
|
||||
OpenClaw içinde sabit kodlanmış değildir.
|
||||
|
||||
Kurulum ayrıntıları için bkz. [/providers/kilocode](/tr/providers/kilocode).
|
||||
Kurulum ayrıntıları için [/providers/kilocode](/tr/providers/kilocode) sayfasına bakın.
|
||||
|
||||
### Diğer paketlenmiş sağlayıcı eklentileri
|
||||
### Diğer paketlenmiş provider Plugin'leri
|
||||
|
||||
- OpenRouter: `openrouter` (`OPENROUTER_API_KEY`)
|
||||
- Örnek model: `openrouter/auto`
|
||||
- OpenClaw, OpenRouter'ın belgelenmiş uygulama atıf üstbilgilerini yalnızca
|
||||
istek gerçekten `openrouter.ai` adresine yöneliyorsa uygular
|
||||
- OpenRouter'a özgü Anthropic `cache_control` işaretçileri de
|
||||
rastgele proxy URL'lerine değil, yalnızca doğrulanmış OpenRouter rotalarına uygulanır
|
||||
- OpenRouter, proxy tarzı OpenAI uyumlu yol üzerinde kalır; bu nedenle doğal
|
||||
yalnızca-OpenAI istek şekillendirmesi (`serviceTier`, Responses `store`,
|
||||
istem önbelleği ipuçları, OpenAI akıl yürütme uyumluluğu yükleri) iletilmez
|
||||
istek gerçekten `openrouter.ai` hedefine gidiyorsa uygular
|
||||
- OpenRouter'a özgü Anthropic `cache_control` işaretçileri de aynı şekilde
|
||||
doğrulanmış OpenRouter yollarıyla sınırlıdır, rastgele proxy URL'leriyle değil
|
||||
- OpenRouter, proxy tarzı OpenAI uyumlu yol üzerinde kalır; bu nedenle
|
||||
yalnızca yerel OpenAI'ye özgü istek şekillendirmesi (`serviceTier`, Responses `store`,
|
||||
prompt-cache ipuçları, OpenAI reasoning-compat payload'ları) iletilmez
|
||||
- Gemini destekli OpenRouter başvuruları yalnızca proxy-Gemini thought-signature temizliğini korur;
|
||||
doğal Gemini yeniden oynatma doğrulaması ve bootstrap yeniden yazımları kapalı kalır
|
||||
yerel Gemini replay doğrulaması ve bootstrap yeniden yazımları kapalı kalır
|
||||
- Kilo Gateway: `kilocode` (`KILOCODE_API_KEY`)
|
||||
- Örnek model: `kilocode/kilo/auto`
|
||||
- Gemini destekli Kilo başvuruları aynı proxy-Gemini thought-signature
|
||||
temizleme yolunu korur; `kilocode/kilo/auto` ve proxy akıl yürütme desteği olmayan diğer
|
||||
ipuçları, proxy akıl yürütme eklemeyi atlar
|
||||
temizleme yolunu korur; `kilocode/kilo/auto` ve proxy muhakeme eklemeyi desteklemeyen
|
||||
diğer ipuçları proxy muhakeme eklemeyi atlar
|
||||
- MiniMax: `minimax` (API anahtarı) ve `minimax-portal` (OAuth)
|
||||
- Kimlik doğrulama: `minimax` için `MINIMAX_API_KEY`; `minimax-portal` için `MINIMAX_OAUTH_TOKEN` veya `MINIMAX_API_KEY`
|
||||
- Örnek model: `minimax/MiniMax-M2.7` veya `minimax-portal/MiniMax-M2.7`
|
||||
- MiniMax katılımı/API anahtarı kurulumu, açık M2.7 model tanımları yazar ve
|
||||
`input: ["text", "image"]` kullanır; paketlenmiş sağlayıcı kataloğu, bu sağlayıcı yapılandırması somutlaştırılana kadar
|
||||
- MiniMax onboarding/API anahtarı kurulumu, açık M2.7 model tanımlarını
|
||||
`input: ["text", "image"]` ile yazar; paketlenmiş sağlayıcı kataloğu bu sağlayıcı yapılandırması somutlaştırılana kadar
|
||||
sohbet başvurularını yalnızca metin olarak tutar
|
||||
- Moonshot: `moonshot` (`MOONSHOT_API_KEY`)
|
||||
- Örnek model: `moonshot/kimi-k2.5`
|
||||
@ -452,11 +456,12 @@ Kurulum ayrıntıları için bkz. [/providers/kilocode](/tr/providers/kilocode).
|
||||
- BytePlus: `byteplus` (`BYTEPLUS_API_KEY`)
|
||||
- Örnek model: `byteplus-plan/ark-code-latest`
|
||||
- xAI: `xai` (`XAI_API_KEY`)
|
||||
- Doğal paketlenmiş xAI istekleri xAI Responses yolunu kullanır
|
||||
- Yerel paketlenmiş xAI istekleri xAI Responses yolunu kullanır
|
||||
- `/fast` veya `params.fastMode: true`, `grok-3`, `grok-3-mini`,
|
||||
`grok-4` ve `grok-4-0709` modellerini kendi `*-fast` varyantlarına yeniden yazar
|
||||
- `tool_stream` varsayılan olarak açıktır; bunu
|
||||
devre dışı bırakmak için `agents.defaults.models["xai/<model>"].params.tool_stream` değerini `false` yapın
|
||||
`grok-4` ve `grok-4-0709` değerlerini kendi `*-fast` varyantlarına yeniden yazar
|
||||
- `tool_stream` varsayılan olarak açıktır; devre dışı bırakmak için
|
||||
`agents.defaults.models["xai/<model>"].params.tool_stream` değerini `false`
|
||||
yapın
|
||||
- Mistral: `mistral` (`MISTRAL_API_KEY`)
|
||||
- Örnek model: `mistral/mistral-large-latest`
|
||||
- CLI: `openclaw onboard --auth-choice mistral-api-key`
|
||||
@ -467,20 +472,19 @@ Kurulum ayrıntıları için bkz. [/providers/kilocode](/tr/providers/kilocode).
|
||||
- GitHub Copilot: `github-copilot` (`COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN`)
|
||||
- Hugging Face Inference örnek modeli: `huggingface/deepseek-ai/DeepSeek-R1`; CLI: `openclaw onboard --auth-choice huggingface-api-key`. Bkz. [Hugging Face (Inference)](/tr/providers/huggingface).
|
||||
|
||||
## `models.providers` üzerinden sağlayıcılar (özel/base URL)
|
||||
## `models.providers` aracılığıyla sağlayıcılar (özel/base URL)
|
||||
|
||||
**Özel** sağlayıcılar veya
|
||||
OpenAI/Anthropic uyumlu proxy'ler eklemek için `models.providers` (veya `models.json`) kullanın.
|
||||
|
||||
Aşağıdaki paketlenmiş sağlayıcı eklentilerinin çoğu zaten varsayılan bir katalog yayımlar.
|
||||
Yalnızca varsayılan
|
||||
base URL, üstbilgiler veya model listesini geçersiz kılmak istediğinizde açık `models.providers.<id>` girdilerini kullanın.
|
||||
Aşağıdaki paketlenmiş provider Plugin'lerinin birçoğu zaten varsayılan bir katalog yayımlar.
|
||||
Varsayılan base URL, üstbilgiler veya model listesini geçersiz kılmak istediğinizde yalnızca açık
|
||||
`models.providers.<id>` girişlerini kullanın.
|
||||
|
||||
### Moonshot AI (Kimi)
|
||||
|
||||
Moonshot, paketlenmiş bir sağlayıcı eklentisi olarak gelir. Varsayılan olarak
|
||||
yerleşik sağlayıcıyı kullanın ve yalnızca base URL veya model meta verisini geçersiz kılmanız gerektiğinde
|
||||
açık bir `models.providers.moonshot` girdisi ekleyin:
|
||||
Moonshot, paketlenmiş bir provider Plugin'i olarak sunulur. Varsayılan olarak yerleşik sağlayıcıyı kullanın;
|
||||
yalnızca base URL veya model meta verisini geçersiz kılmanız gerektiğinde açık bir `models.providers.moonshot` girdisi ekleyin:
|
||||
|
||||
- Sağlayıcı: `moonshot`
|
||||
- Kimlik doğrulama: `MOONSHOT_API_KEY`
|
||||
@ -534,13 +538,13 @@ Kimi Coding, Moonshot AI'nin Anthropic uyumlu uç noktasını kullanır:
|
||||
}
|
||||
```
|
||||
|
||||
Eski `kimi/k2p5`, uyumluluk model kimliği olarak kabul edilmeye devam eder.
|
||||
Eski `kimi/k2p5` kimliği uyumluluk model kimliği olarak kabul edilmeye devam eder.
|
||||
|
||||
### Volcano Engine (Doubao)
|
||||
|
||||
Volcano Engine (火山引擎), Çin'de Doubao ve diğer modellere erişim sağlar.
|
||||
|
||||
- Sağlayıcı: `volcengine` (coding: `volcengine-plan`)
|
||||
- Sağlayıcı: `volcengine` (kodlama: `volcengine-plan`)
|
||||
- Kimlik doğrulama: `VOLCANO_ENGINE_API_KEY`
|
||||
- Örnek model: `volcengine-plan/ark-code-latest`
|
||||
- CLI: `openclaw onboard --auth-choice volcengine-api-key`
|
||||
@ -553,13 +557,13 @@ Volcano Engine (火山引擎), Çin'de Doubao ve diğer modellere erişim sağla
|
||||
}
|
||||
```
|
||||
|
||||
Katılım varsayılan olarak coding yüzeyini kullanır, ancak genel `volcengine/*`
|
||||
Onboarding varsayılan olarak kodlama yüzeyini kullanır, ancak genel `volcengine/*`
|
||||
kataloğu da aynı anda kaydedilir.
|
||||
|
||||
Katılım/model yapılandırma seçicilerinde, Volcengine kimlik doğrulama seçeneği hem
|
||||
Onboarding/model yapılandırma seçicilerinde Volcengine kimlik doğrulama seçeneği hem
|
||||
`volcengine/*` hem de `volcengine-plan/*` satırlarını tercih eder. Bu modeller henüz yüklenmemişse,
|
||||
OpenClaw boş bir sağlayıcı kapsamlı seçici göstermek yerine
|
||||
filtrelenmemiş kataloğa geri döner.
|
||||
filtresiz kataloğa geri döner.
|
||||
|
||||
Kullanılabilir modeller:
|
||||
|
||||
@ -569,7 +573,7 @@ Kullanılabilir modeller:
|
||||
- `volcengine/glm-4-7-251222` (GLM 4.7)
|
||||
- `volcengine/deepseek-v3-2-251201` (DeepSeek V3.2 128K)
|
||||
|
||||
Coding modelleri (`volcengine-plan`):
|
||||
Kodlama modelleri (`volcengine-plan`):
|
||||
|
||||
- `volcengine-plan/ark-code-latest`
|
||||
- `volcengine-plan/doubao-seed-code`
|
||||
@ -581,7 +585,7 @@ Coding modelleri (`volcengine-plan`):
|
||||
|
||||
BytePlus ARK, uluslararası kullanıcılar için Volcano Engine ile aynı modellere erişim sağlar.
|
||||
|
||||
- Sağlayıcı: `byteplus` (coding: `byteplus-plan`)
|
||||
- Sağlayıcı: `byteplus` (kodlama: `byteplus-plan`)
|
||||
- Kimlik doğrulama: `BYTEPLUS_API_KEY`
|
||||
- Örnek model: `byteplus-plan/ark-code-latest`
|
||||
- CLI: `openclaw onboard --auth-choice byteplus-api-key`
|
||||
@ -594,13 +598,13 @@ BytePlus ARK, uluslararası kullanıcılar için Volcano Engine ile aynı modell
|
||||
}
|
||||
```
|
||||
|
||||
Katılım varsayılan olarak coding yüzeyini kullanır, ancak genel `byteplus/*`
|
||||
Onboarding varsayılan olarak kodlama yüzeyini kullanır, ancak genel `byteplus/*`
|
||||
kataloğu da aynı anda kaydedilir.
|
||||
|
||||
Katılım/model yapılandırma seçicilerinde, BytePlus kimlik doğrulama seçeneği hem
|
||||
Onboarding/model yapılandırma seçicilerinde BytePlus kimlik doğrulama seçeneği hem
|
||||
`byteplus/*` hem de `byteplus-plan/*` satırlarını tercih eder. Bu modeller henüz yüklenmemişse,
|
||||
OpenClaw boş bir sağlayıcı kapsamlı seçici göstermek yerine
|
||||
filtrelenmemiş kataloğa geri döner.
|
||||
filtresiz kataloğa geri döner.
|
||||
|
||||
Kullanılabilir modeller:
|
||||
|
||||
@ -608,7 +612,7 @@ Kullanılabilir modeller:
|
||||
- `byteplus/kimi-k2-5-260127` (Kimi K2.5)
|
||||
- `byteplus/glm-4-7-251222` (GLM 4.7)
|
||||
|
||||
Coding modelleri (`byteplus-plan`):
|
||||
Kodlama modelleri (`byteplus-plan`):
|
||||
|
||||
- `byteplus-plan/ark-code-latest`
|
||||
- `byteplus-plan/doubao-seed-code`
|
||||
@ -655,22 +659,44 @@ MiniMax, özel uç noktalar kullandığı için `models.providers` üzerinden ya
|
||||
- Kimlik doğrulama: `minimax` için `MINIMAX_API_KEY`; `minimax-portal` için `MINIMAX_OAUTH_TOKEN` veya
|
||||
`MINIMAX_API_KEY`
|
||||
|
||||
Kurulum ayrıntıları, model seçenekleri ve yapılandırma parçacıkları için bkz. [/providers/minimax](/tr/providers/minimax).
|
||||
Kurulum ayrıntıları, model seçenekleri ve yapılandırma parçacıkları için [/providers/minimax](/tr/providers/minimax) sayfasına bakın.
|
||||
|
||||
MiniMax'ın Anthropic uyumlu akış yolunda, OpenClaw düşünmeyi
|
||||
siz açıkça ayarlamadığınız sürece varsayılan olarak devre dışı bırakır ve `/fast on`,
|
||||
`MiniMax-M2.7` modelini `MiniMax-M2.7-highspeed` olarak yeniden yazar.
|
||||
MiniMax'in Anthropic uyumlu akış yolunda OpenClaw,
|
||||
açıkça ayarlamadığınız sürece varsayılan olarak thinking'i devre dışı bırakır ve `/fast on`
|
||||
`MiniMax-M2.7` değerini `MiniMax-M2.7-highspeed` olarak yeniden yazar.
|
||||
|
||||
Eklentiye ait yetenek ayrımı:
|
||||
Plugin'e ait yetenek ayrımı:
|
||||
|
||||
- Metin/sohbet varsayılanları `minimax/MiniMax-M2.7` üzerinde kalır
|
||||
- Görsel oluşturma `minimax/image-01` veya `minimax-portal/image-01` olarak yapılır
|
||||
- Görsel anlama, her iki MiniMax kimlik doğrulama yolunda da eklentiye ait `MiniMax-VL-01` kullanır
|
||||
- Web araması sağlayıcı kimliği `minimax` üzerinde kalır
|
||||
- Görsel oluşturma `minimax/image-01` veya `minimax-portal/image-01` olur
|
||||
- Görsel anlama, her iki MiniMax kimlik doğrulama yolunda da Plugin'e ait `MiniMax-VL-01`'dir
|
||||
- Web araması `minimax` sağlayıcı kimliğinde kalır
|
||||
|
||||
### LM Studio
|
||||
|
||||
LM Studio, yerel API'yi kullanan paketlenmiş bir provider Plugin'i olarak sunulur:
|
||||
|
||||
- Sağlayıcı: `lmstudio`
|
||||
- Kimlik doğrulama: `LM_API_TOKEN`
|
||||
- Varsayılan çıkarım base URL'si: `http://localhost:1234/v1`
|
||||
|
||||
Ardından bir model ayarlayın (`http://localhost:1234/api/v1/models` tarafından döndürülen kimliklerden biriyle değiştirin):
|
||||
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
OpenClaw, keşif + otomatik yükleme için LM Studio'nun yerel `/api/v1/models` ve `/api/v1/models/load`
|
||||
uç noktalarını, varsayılan olarak çıkarım için ise `/v1/chat/completions` uç noktasını kullanır.
|
||||
Kurulum ve sorun giderme için [/providers/lmstudio](/tr/providers/lmstudio) sayfasına bakın.
|
||||
|
||||
### Ollama
|
||||
|
||||
Ollama, paketlenmiş bir sağlayıcı eklentisi olarak gelir ve Ollama'nın doğal API'sini kullanır:
|
||||
Ollama, paketlenmiş bir provider Plugin'i olarak sunulur ve Ollama'nın yerel API'sini kullanır:
|
||||
|
||||
- Sağlayıcı: `ollama`
|
||||
- Kimlik doğrulama: Gerekmez (yerel sunucu)
|
||||
@ -690,21 +716,20 @@ ollama pull llama3.3
|
||||
}
|
||||
```
|
||||
|
||||
Ollama, `OLLAMA_API_KEY` ile etkinleştirdiğinizde yerelde `http://127.0.0.1:11434` adresinde algılanır
|
||||
ve paketlenmiş sağlayıcı eklentisi Ollama'yı doğrudan
|
||||
`openclaw onboard` ve model seçiciye ekler. Katılım, bulut/yerel mod ve özel yapılandırma için
|
||||
bkz. [/providers/ollama](/tr/providers/ollama).
|
||||
`OLLAMA_API_KEY` ile katılım sağladığınızda Ollama yerel olarak `http://127.0.0.1:11434` adresinde algılanır ve paketlenmiş provider Plugin'i Ollama'yı doğrudan
|
||||
`openclaw onboard` ve model seçiciye ekler. Onboarding, bulut/yerel mod ve özel yapılandırma için [/providers/ollama](/tr/providers/ollama)
|
||||
sayfasına bakın.
|
||||
|
||||
### vLLM
|
||||
|
||||
vLLM, yerel/self-hosted OpenAI uyumlu
|
||||
sunucular için paketlenmiş bir sağlayıcı eklentisi olarak gelir:
|
||||
sunucular için paketlenmiş bir provider Plugin'i olarak sunulur:
|
||||
|
||||
- Sağlayıcı: `vllm`
|
||||
- Kimlik doğrulama: İsteğe bağlıdır (sunucunuza bağlıdır)
|
||||
- Varsayılan base URL: `http://127.0.0.1:8000/v1`
|
||||
|
||||
Yerelde otomatik keşfi etkinleştirmek için (sunucunuz kimlik doğrulamayı zorunlu kılmıyorsa herhangi bir değer çalışır):
|
||||
Yerelde otomatik keşfe katılmak için (sunucunuz kimlik doğrulamayı zorlamıyorsa herhangi bir değer çalışır):
|
||||
|
||||
```bash
|
||||
export VLLM_API_KEY="vllm-local"
|
||||
@ -720,19 +745,19 @@ Ardından bir model ayarlayın (`/v1/models` tarafından döndürülen kimlikler
|
||||
}
|
||||
```
|
||||
|
||||
Ayrıntılar için bkz. [/providers/vllm](/tr/providers/vllm).
|
||||
Ayrıntılar için [/providers/vllm](/tr/providers/vllm) sayfasına bakın.
|
||||
|
||||
### SGLang
|
||||
|
||||
SGLang, hızlı self-hosted
|
||||
OpenAI uyumlu sunucular için paketlenmiş bir sağlayıcı eklentisi olarak gelir:
|
||||
OpenAI uyumlu sunucular için paketlenmiş bir provider Plugin'i olarak sunulur:
|
||||
|
||||
- Sağlayıcı: `sglang`
|
||||
- Kimlik doğrulama: İsteğe bağlıdır (sunucunuza bağlıdır)
|
||||
- Varsayılan base URL: `http://127.0.0.1:30000/v1`
|
||||
|
||||
Yerelde otomatik keşfi etkinleştirmek için (sunucunuz kimlik doğrulamayı
|
||||
zorunlu kılmıyorsa herhangi bir değer çalışır):
|
||||
Yerelde otomatik keşfe katılmak için (sunucunuz kimlik doğrulamayı
|
||||
zorlamıyorsa herhangi bir değer çalışır):
|
||||
|
||||
```bash
|
||||
export SGLANG_API_KEY="sglang-local"
|
||||
@ -748,7 +773,7 @@ Ardından bir model ayarlayın (`/v1/models` tarafından döndürülen kimlikler
|
||||
}
|
||||
```
|
||||
|
||||
Ayrıntılar için bkz. [/providers/sglang](/tr/providers/sglang).
|
||||
Ayrıntılar için [/providers/sglang](/tr/providers/sglang) sayfasına bakın.
|
||||
|
||||
### Yerel proxy'ler (LM Studio, vLLM, LiteLLM vb.)
|
||||
|
||||
@ -766,7 +791,7 @@ Ayrıntılar için bkz. [/providers/sglang](/tr/providers/sglang).
|
||||
providers: {
|
||||
lmstudio: {
|
||||
baseUrl: "http://localhost:1234/v1",
|
||||
apiKey: "LMSTUDIO_KEY",
|
||||
apiKey: "${LM_API_TOKEN}",
|
||||
api: "openai-completions",
|
||||
models: [
|
||||
{
|
||||
@ -788,20 +813,20 @@ Ayrıntılar için bkz. [/providers/sglang](/tr/providers/sglang).
|
||||
Notlar:
|
||||
|
||||
- Özel sağlayıcılar için `reasoning`, `input`, `cost`, `contextWindow` ve `maxTokens` isteğe bağlıdır.
|
||||
Atlandığında OpenClaw şu varsayılanları kullanır:
|
||||
Belirtilmediğinde OpenClaw varsayılan olarak şunları kullanır:
|
||||
- `reasoning: false`
|
||||
- `input: ["text"]`
|
||||
- `cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }`
|
||||
- `contextWindow: 200000`
|
||||
- `maxTokens: 8192`
|
||||
- Önerilir: proxy/model sınırlarınızla eşleşen açık değerler ayarlayın.
|
||||
- Doğal olmayan uç noktalardaki `api: "openai-completions"` için (ana makinesi `api.openai.com` olmayan boş olmayan herhangi bir `baseUrl`), OpenClaw, desteklenmeyen `developer` rolleri için sağlayıcı 400 hatalarından kaçınmak amacıyla `compat.supportsDeveloperRole: false` değerini zorunlu kılar.
|
||||
- Proxy tarzı OpenAI uyumlu yollar ayrıca doğal yalnızca-OpenAI istek
|
||||
şekillendirmesini de atlar: `service_tier` yok, Responses `store` yok, istem önbelleği ipuçları yok,
|
||||
OpenAI akıl yürütme uyumluluğu yük şekillendirmesi yok ve gizli OpenClaw atıf
|
||||
- Yerel olmayan uç noktalardaki `api: "openai-completions"` için (`baseUrl` boş olmayan ve ana makinesi `api.openai.com` olmayan her URL), OpenClaw desteklenmeyen `developer` rolleri için sağlayıcı 400 hatalarını önlemek amacıyla `compat.supportsDeveloperRole: false` değerini zorunlu kılar.
|
||||
- Proxy tarzı OpenAI uyumlu yollar, yerel OpenAI'ye özgü istek
|
||||
şekillendirmesini de atlar: `service_tier` yok, Responses `store` yok, prompt-cache ipuçları yok,
|
||||
OpenAI reasoning-compat payload şekillendirmesi yok ve gizli OpenClaw atıf
|
||||
üstbilgileri yok.
|
||||
- `baseUrl` boşsa/atlanmışsa, OpenClaw varsayılan OpenAI davranışını korur (`api.openai.com` adresine çözülür).
|
||||
- Güvenlik için, açıkça belirtilen `compat.supportsDeveloperRole: true` değeri bile doğal olmayan `openai-completions` uç noktalarında yine geçersiz kılınır.
|
||||
- `baseUrl` boşsa/belirtilmemişse OpenClaw varsayılan OpenAI davranışını korur (bu da `api.openai.com` adresine çözülür).
|
||||
- Güvenlik için, yerel olmayan `openai-completions` uç noktalarında açık bir `compat.supportsDeveloperRole: true` değeri yine de geçersiz kılınır.
|
||||
|
||||
## CLI örnekleri
|
||||
|
||||
@ -817,5 +842,5 @@ Ayrıca bkz.: tam yapılandırma örnekleri için [/gateway/configuration](/tr/g
|
||||
|
||||
- [Models](/tr/concepts/models) — model yapılandırması ve takma adlar
|
||||
- [Model Failover](/tr/concepts/model-failover) — geri dönüş zincirleri ve yeniden deneme davranışı
|
||||
- [Yapılandırma Başvurusu](/tr/gateway/configuration-reference#agent-defaults) — model yapılandırma anahtarları
|
||||
- [Sağlayıcılar](/tr/providers) — sağlayıcı bazında kurulum kılavuzları
|
||||
- [Configuration Reference](/tr/gateway/configuration-reference#agent-defaults) — model yapılandırma anahtarları
|
||||
- [Providers](/tr/providers) — sağlayıcı bazında kurulum kılavuzları
|
||||
|
||||
@ -2,36 +2,36 @@
|
||||
read_when:
|
||||
- qa-lab veya qa-channel'ı genişletme
|
||||
- Depo destekli QA senaryoları ekleme
|
||||
- Gateway panosu etrafında daha yüksek gerçekçilikli QA otomasyonu oluşturma
|
||||
summary: qa-lab, qa-channel, seedlenmiş senaryolar ve protokol raporları için özel QA otomasyon yapısı
|
||||
title: QA Uçtan Uca Otomasyon
|
||||
- Gateway panosu etrafında daha yüksek gerçekçiliğe sahip QA otomasyonu oluşturma
|
||||
summary: qa-lab, qa-channel, tohumlanmış senaryolar ve protokol raporları için özel QA otomasyon yapısı
|
||||
title: QA E2E Otomasyonu
|
||||
x-i18n:
|
||||
generated_at: "2026-04-12T23:28:03Z"
|
||||
generated_at: "2026-04-13T08:50:47Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: b9fe27dc049823d5e3eb7ae1eac6aad21ed9e917425611fb1dbcb28ab9210d5e
|
||||
source_hash: a4a4f5c765163565c95c2a071f201775fd9d8d60cad4ff25d71e4710559c1570
|
||||
source_path: concepts/qa-e2e-automation.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# QA Uçtan Uca Otomasyon
|
||||
# QA E2E Otomasyonu
|
||||
|
||||
Özel QA yığını, OpenClaw'ı tek birim testinin yapabileceğinden daha gerçekçi,
|
||||
kanal biçimli bir şekilde çalıştırmak için tasarlanmıştır.
|
||||
kanal biçimli bir şekilde çalıştırmayı amaçlar.
|
||||
|
||||
Mevcut parçalar:
|
||||
|
||||
- `extensions/qa-channel`: DM, kanal, ileti dizisi,
|
||||
tepki, düzenleme ve silme yüzeylerine sahip sentetik mesaj kanalı.
|
||||
- `extensions/qa-lab`: transkripti gözlemlemek,
|
||||
gelen mesajları enjekte etmek ve bir Markdown raporu dışa aktarmak için hata ayıklayıcı arayüzü ve QA veri yolu.
|
||||
gelen mesajları enjekte etmek ve bir Markdown raporu dışa aktarmak için hata ayıklayıcı UI ve QA veri yolu.
|
||||
- `qa/`: başlangıç görevi ve temel QA
|
||||
senaryoları için depo destekli tohum varlıkları.
|
||||
|
||||
Mevcut QA operatörü akışı iki panelli bir QA sitesidir:
|
||||
Mevcut QA operatör akışı iki bölmeli bir QA sitesidir:
|
||||
|
||||
- Sol: ajan ile Gateway panosu (Control UI).
|
||||
- Sağ: Slack benzeri transkript ve senaryo planını gösteren QA Lab.
|
||||
- Sol: ajanla birlikte Gateway panosu (Control UI).
|
||||
- Sağ: Slack benzeri transkripti ve senaryo planını gösteren QA Lab.
|
||||
|
||||
Bunu şu komutla çalıştırın:
|
||||
|
||||
@ -39,13 +39,13 @@ Bunu şu komutla çalıştırın:
|
||||
pnpm qa:lab:up
|
||||
```
|
||||
|
||||
Bu, QA sitesini derler, Docker destekli gateway hattını başlatır ve
|
||||
bir operatörün veya otomasyon döngüsünün ajana bir QA görevi verebildiği,
|
||||
gerçek kanal davranışını gözlemleyebildiği ve neyin çalıştığını, neyin başarısız olduğunu
|
||||
veya neyin engelli kaldığını kaydedebildiği QA Lab sayfasını kullanıma açar.
|
||||
Bu, QA sitesini oluşturur, Docker destekli gateway hattını başlatır ve
|
||||
bir operatörün veya otomasyon döngüsünün ajana bir QA
|
||||
görevi verebildiği, gerçek kanal davranışını gözlemleyebildiği ve neyin çalıştığını, başarısız olduğunu veya
|
||||
engelli kaldığını kaydedebildiği QA Lab sayfasını açığa çıkarır.
|
||||
|
||||
Docker imajını her seferinde yeniden derlemeden daha hızlı QA Lab UI yinelemesi
|
||||
için, yığını bind-mounted bir QA Lab paketiyle başlatın:
|
||||
Docker image'ını her seferinde yeniden oluşturmadan daha hızlı QA Lab UI yinelemesi için,
|
||||
yığını bind-mounted bir QA Lab paketiyle başlatın:
|
||||
|
||||
```bash
|
||||
pnpm openclaw qa docker-build-image
|
||||
@ -54,90 +54,95 @@ pnpm qa:lab:up:fast
|
||||
pnpm qa:lab:watch
|
||||
```
|
||||
|
||||
`qa:lab:up:fast`, Docker servislerini önceden derlenmiş bir imaj üzerinde tutar ve
|
||||
`extensions/qa-lab/web/dist` dizinini `qa-lab` kapsayıcısına bind mount eder. `qa:lab:watch`
|
||||
bu paketi değişiklik olduğunda yeniden derler ve QA Lab varlık karması değiştiğinde
|
||||
tarayıcı otomatik olarak yeniden yüklenir.
|
||||
`qa:lab:up:fast`, Docker servislerini önceden oluşturulmuş bir image üzerinde tutar ve
|
||||
`extensions/qa-lab/web/dist` dizinini `qa-lab` container'ına bind-mount eder. `qa:lab:watch`
|
||||
değişiklikte bu paketi yeniden oluşturur ve QA Lab
|
||||
varlık hash'i değiştiğinde tarayıcı otomatik olarak yeniden yüklenir.
|
||||
|
||||
Taşıma açısından gerçek bir Matrix duman testi hattı için şunu çalıştırın:
|
||||
Taşıma açısından gerçek bir Matrix smoke hattı için şunu çalıştırın:
|
||||
|
||||
```bash
|
||||
pnpm openclaw qa matrix
|
||||
```
|
||||
|
||||
Bu hat, Docker içinde tek kullanımlık bir Tuwunel homeserver sağlar,
|
||||
geçici sürücü, SUT ve gözlemci kullanıcılarını kaydeder, bir özel oda oluşturur,
|
||||
ardından gerçek Matrix Plugin'ini bir QA gateway alt süreci içinde çalıştırır. Canlı taşıma hattı,
|
||||
alt süreç yapılandırmasını test edilen taşımayla sınırlı tutar; böylece Matrix,
|
||||
alt süreç yapılandırmasında `qa-channel` olmadan çalışır.
|
||||
Bu hat, Docker içinde tek kullanımlık bir Tuwunel homeserver sağlar, geçici
|
||||
sürücü, SUT ve gözlemci kullanıcıları kaydeder, bir özel oda oluşturur, ardından
|
||||
gerçek Matrix Plugin'ini bir QA gateway child içinde çalıştırır. Canlı taşıma hattı child config'i
|
||||
test edilen taşımaya kapsamlı tutar; bu nedenle Matrix, child config içinde
|
||||
`qa-channel` olmadan çalışır.
|
||||
|
||||
Taşıma açısından gerçek bir Telegram duman testi hattı için şunu çalıştırın:
|
||||
Taşıma açısından gerçek bir Telegram smoke hattı için şunu çalıştırın:
|
||||
|
||||
```bash
|
||||
pnpm openclaw qa telegram
|
||||
```
|
||||
|
||||
Bu hat, tek kullanımlık bir sunucu sağlamak yerine bir gerçek özel Telegram grubunu hedefler.
|
||||
Bu hat, tek kullanımlık bir sunucu sağlamak yerine gerçek bir özel Telegram grubunu hedefler.
|
||||
`OPENCLAW_QA_TELEGRAM_GROUP_ID`,
|
||||
`OPENCLAW_QA_TELEGRAM_DRIVER_BOT_TOKEN` ve
|
||||
`OPENCLAW_QA_TELEGRAM_SUT_BOT_TOKEN` gerektirir; ayrıca aynı
|
||||
özel grupta iki farklı bot gerekir. SUT botunun bir Telegram kullanıcı adına sahip olması gerekir ve
|
||||
bottan bota gözlem, her iki botta da `@BotFather` içinde
|
||||
Bot-to-Bot Communication Mode etkin olduğunda en iyi şekilde çalışır.
|
||||
özel grupta iki ayrı bot gerekir. SUT botunun bir Telegram kullanıcı adı olmalıdır ve
|
||||
botlar arası gözlem, her iki botta da
|
||||
`@BotFather` içinde Bot-to-Bot Communication Mode etkinleştirildiğinde en iyi şekilde çalışır.
|
||||
|
||||
Canlı taşıma hatları artık her birinin kendi senaryo listesi şeklini icat etmesi yerine
|
||||
ortak, daha küçük bir sözleşmeyi paylaşır:
|
||||
Canlı taşıma hatları artık her birinin kendi senaryo listesi şeklini
|
||||
icat etmesi yerine ortak, daha küçük bir sözleşmeyi paylaşıyor:
|
||||
|
||||
`qa-channel`, geniş sentetik ürün davranışı paketi olarak kalır ve
|
||||
`qa-channel`, geniş sentetik ürün davranışı paketi olmaya devam eder ve
|
||||
canlı taşıma kapsam matriksinin bir parçası değildir.
|
||||
|
||||
| Hat | Canary | Mention gating | Allowlist block | Üst düzey yanıt | Yeniden başlatma sonrası sürdürme | İleti dizisi takibi | İleti dizisi izolasyonu | Tepki gözlemi | Yardım komutu |
|
||||
| -------- | ------ | -------------- | --------------- | --------------- | --------------------------------- | ------------------- | ----------------------- | ------------- | ------------- |
|
||||
| Matrix | x | x | x | x | x | x | x | x | |
|
||||
| Telegram | x | | | | | | | | x |
|
||||
| Hat | Canary | Mention gating | Allowlist block | Üst düzey yanıt | Yeniden başlatma sonrası sürdürme | İleti dizisi takibi | İleti dizisi yalıtımı | Tepki gözlemi | Yardım komutu |
|
||||
| -------- | ------ | -------------- | --------------- | --------------- | --------------------------------- | ------------------- | -------------------- | ------------- | ------------- |
|
||||
| Matrix | x | x | x | x | x | x | x | x | |
|
||||
| Telegram | x | | | | | | | | x |
|
||||
|
||||
Bu, `qa-channel`'ı geniş ürün davranışı paketi olarak korurken Matrix,
|
||||
Telegram ve gelecekteki canlı taşıma sistemlerinin açık bir taşıma sözleşmesi
|
||||
kontrol listesini paylaşmasını sağlar.
|
||||
Telegram ve gelecekteki canlı taşımaların tek bir açık
|
||||
taşıma sözleşmesi kontrol listesini paylaşmasını sağlar.
|
||||
|
||||
Docker'ı QA yoluna dahil etmeden tek kullanımlık bir Linux VM hattı için şunu çalıştırın:
|
||||
QA yoluna Docker katmadan tek kullanımlık bir Linux VM hattı için şunu çalıştırın:
|
||||
|
||||
```bash
|
||||
pnpm openclaw qa suite --runner multipass --scenario channel-chat-baseline
|
||||
```
|
||||
|
||||
Bu, yeni bir Multipass misafirini başlatır, bağımlılıkları kurar, OpenClaw'ı
|
||||
misafir içinde derler, `qa suite` çalıştırır, ardından normal QA raporunu ve
|
||||
özeti tekrar ana makinede `.artifacts/qa-e2e/...` içine kopyalar.
|
||||
Ana makinedeki `qa suite` ile aynı senaryo seçim davranışını yeniden kullanır.
|
||||
Ana makine ve Multipass paket çalıştırmaları, varsayılan olarak izole gateway çalışanlarıyla
|
||||
birden çok seçilmiş senaryoyu paralel çalıştırır; en fazla 64 çalışan veya seçilen
|
||||
senaryo sayısı kadar. Çalışan sayısını ayarlamak için `--concurrency <count>`,
|
||||
Bu, yeni bir Multipass guest'i başlatır, bağımlılıkları kurar, guest içinde OpenClaw'ı oluşturur,
|
||||
`qa suite` çalıştırır, ardından normal QA raporunu ve
|
||||
özetini host üzerindeki `.artifacts/qa-e2e/...` dizinine geri kopyalar.
|
||||
Host üzerindeki `qa suite` ile aynı senaryo seçimi davranışını yeniden kullanır.
|
||||
Host ve Multipass suite çalıştırmaları, varsayılan olarak
|
||||
yalıtılmış gateway worker'larıyla birden çok seçilmiş senaryoyu paralel çalıştırır; en fazla 64 worker veya seçilen
|
||||
senaryo sayısı kullanılır. Worker sayısını ayarlamak için `--concurrency <count>`,
|
||||
seri yürütme için ise `--concurrency 1` kullanın.
|
||||
Canlı çalıştırmalar, misafir için pratik olan desteklenen QA kimlik doğrulama girdilerini iletir:
|
||||
ortam değişkeni tabanlı sağlayıcı anahtarları, QA canlı sağlayıcı yapılandırma yolu ve
|
||||
varsa `CODEX_HOME`. Misafirin bağlanmış çalışma alanı üzerinden geri yazabilmesi için
|
||||
`--output-dir` değerini depo kökü altında tutun.
|
||||
Canlı çalıştırmalar, guest için pratik olan desteklenen QA kimlik doğrulama girdilerini iletir:
|
||||
env tabanlı sağlayıcı anahtarları, QA canlı sağlayıcı config yolu ve
|
||||
varsa `CODEX_HOME`. Guest'in
|
||||
bağlı çalışma alanı üzerinden geri yazabilmesi için `--output-dir` değerini depo kökü altında tutun.
|
||||
|
||||
## Depo destekli tohumlar
|
||||
|
||||
Tohum varlıkları `qa/` altında bulunur:
|
||||
Tohum varlıkları `qa/` içinde bulunur:
|
||||
|
||||
- `qa/scenarios/index.md`
|
||||
- `qa/scenarios/*.md`
|
||||
|
||||
Bunlar kasıtlı olarak git içinde tutulur; böylece QA planı hem insanlar hem de
|
||||
ajan tarafından görülebilir.
|
||||
Bunlar kasıtlı olarak git içindedir; böylece QA planı hem insanlar hem de
|
||||
ajan için görünür olur.
|
||||
|
||||
`qa-lab` genel bir markdown çalıştırıcısı olarak kalmalıdır. Her senaryo markdown dosyası
|
||||
`qa-lab` genel amaçlı bir markdown çalıştırıcısı olarak kalmalıdır. Her senaryo markdown dosyası
|
||||
tek bir test çalıştırmasının doğruluk kaynağıdır ve şunları tanımlamalıdır:
|
||||
|
||||
- senaryo meta verileri
|
||||
- doküman ve kod referansları
|
||||
- isteğe bağlı Plugin gereksinimleri
|
||||
- isteğe bağlı gateway yapılandırma yaması
|
||||
- isteğe bağlı gateway config yaması
|
||||
- yürütülebilir `qa-flow`
|
||||
|
||||
`qa-flow`'u destekleyen yeniden kullanılabilir çalışma zamanı yüzeyinin genel amaçlı
|
||||
ve kesitler arası kalmasına izin verilir. Örneğin markdown senaryoları,
|
||||
özel durumlu bir çalıştırıcı eklemeden gömülü Control UI'ı
|
||||
Gateway `browser.request` yüzeyi üzerinden süren tarayıcı tarafı yardımcılarıyla taşıma tarafı yardımcılarını birleştirebilir.
|
||||
|
||||
Temel liste, şunları kapsayacak kadar geniş kalmalıdır:
|
||||
|
||||
- DM ve kanal sohbeti
|
||||
@ -146,25 +151,25 @@ Temel liste, şunları kapsayacak kadar geniş kalmalıdır:
|
||||
- Cron geri çağrıları
|
||||
- bellekten geri çağırma
|
||||
- model değiştirme
|
||||
- alt ajan devretme
|
||||
- alt ajan devri
|
||||
- depo okuma ve doküman okuma
|
||||
- Lobster Invaders gibi küçük bir derleme görevi
|
||||
|
||||
## Taşıma bağdaştırıcıları
|
||||
|
||||
`qa-lab`, markdown QA senaryoları için genel bir taşıma katmanına sahiptir.
|
||||
`qa-channel`, bu katmandaki ilk bağdaştırıcıdır, ancak tasarım hedefi daha geniştir:
|
||||
gelecekteki gerçek veya sentetik kanallar, taşımaya özel bir QA çalıştırıcısı eklemek yerine
|
||||
aynı paket çalıştırıcısına bağlanmalıdır.
|
||||
`qa-lab`, markdown QA senaryoları için genel bir taşıma yüzeyine sahiptir.
|
||||
`qa-channel`, bu yüzeydeki ilk bağdaştırıcıdır; ancak tasarım hedefi daha geniştir:
|
||||
gelecekteki gerçek veya sentetik kanallar, taşımaya özgü bir QA çalıştırıcısı eklemek yerine
|
||||
aynı suite çalıştırıcısına takılmalıdır.
|
||||
|
||||
Mimari düzeyde ayrım şöyledir:
|
||||
|
||||
- `qa-lab`, genel senaryo yürütmeyi, çalışan eşzamanlılığını, yapıt yazmayı ve raporlamayı yönetir.
|
||||
- taşıma bağdaştırıcısı, gateway yapılandırmasını, hazır olma durumunu, gelen ve giden gözlemi, taşıma eylemlerini ve normalize edilmiş taşıma durumunu yönetir.
|
||||
- `qa/scenarios/` altındaki markdown senaryo dosyaları test çalıştırmasını tanımlar; `qa-lab` bunları yürüten yeniden kullanılabilir çalışma zamanı yüzeyini sağlar.
|
||||
- `qa-lab`, genel senaryo yürütmeyi, worker eşzamanlılığını, artifact yazmayı ve raporlamayı yönetir.
|
||||
- taşıma bağdaştırıcısı gateway config'ini, hazır olma durumunu, gelen ve giden gözlemi, taşıma eylemlerini ve normalize edilmiş taşıma durumunu yönetir.
|
||||
- `qa/scenarios/` altındaki markdown senaryo dosyaları test çalıştırmasını tanımlar; bunları yürüten yeniden kullanılabilir çalışma zamanı yüzeyini `qa-lab` sağlar.
|
||||
|
||||
Yeni kanal bağdaştırıcıları için bakımcıya yönelik uyarlama rehberi
|
||||
[Testing](/tr/help/testing#adding-a-channel-to-qa) içinde yer alır.
|
||||
Yeni kanal bağdaştırıcıları için bakımcıya yönelik benimseme yönergeleri
|
||||
[Testing](/tr/help/testing#adding-a-channel-to-qa) içinde bulunur.
|
||||
|
||||
## Raporlama
|
||||
|
||||
@ -176,8 +181,8 @@ Rapor şu sorulara yanıt vermelidir:
|
||||
- Ne engelli kaldı
|
||||
- Hangi takip senaryolarını eklemeye değer
|
||||
|
||||
Karakter ve stil kontrolleri için, aynı senaryoyu birden çok canlı model referansı üzerinde
|
||||
çalıştırın ve değerlendirilmiş bir Markdown raporu yazın:
|
||||
Karakter ve stil kontrolleri için aynı senaryoyu birden çok canlı model
|
||||
ref'i üzerinde çalıştırın ve değerlendirilmiş bir Markdown raporu yazın:
|
||||
|
||||
```bash
|
||||
pnpm openclaw qa character-eval \
|
||||
@ -196,35 +201,35 @@ pnpm openclaw qa character-eval \
|
||||
--judge-concurrency 16
|
||||
```
|
||||
|
||||
Komut Docker değil, yerel QA gateway alt süreçleri çalıştırır. Karakter değerlendirme
|
||||
senaryoları kişiliği `SOUL.md` üzerinden ayarlamalı, ardından sohbet, çalışma alanı yardımı
|
||||
ve küçük dosya görevleri gibi sıradan kullanıcı turlarını çalıştırmalıdır. Aday modele
|
||||
değerlendirildiği söylenmemelidir. Komut her tam transkripti korur, temel çalıştırma
|
||||
istatistiklerini kaydeder, ardından değerlendirme modellerinden hızlı modda ve
|
||||
`xhigh` akıl yürütme ile çalıştırmaları doğallık, hava ve mizah açısından sıralamalarını ister.
|
||||
Komut, Docker değil, yerel QA gateway child süreçlerini çalıştırır. Character eval
|
||||
senaryoları persona'yı `SOUL.md` üzerinden ayarlamalı, ardından sohbet,
|
||||
çalışma alanı yardımı ve küçük dosya görevleri gibi sıradan kullanıcı turlarını çalıştırmalıdır. Aday modele
|
||||
değerlendirildiği söylenmemelidir. Komut her tam
|
||||
transkripti korur, temel çalışma istatistiklerini kaydeder, ardından değerlendirme modellerinden fast mode ile
|
||||
`xhigh` akıl yürütme kullanarak çalıştırmaları doğallık, hava ve mizaha göre sıralamalarını ister.
|
||||
Sağlayıcıları karşılaştırırken `--blind-judge-models` kullanın: değerlendirme istemi yine de
|
||||
her transkripti ve çalıştırma durumunu alır, ancak aday referansları `candidate-01` gibi nötr
|
||||
etiketlerle değiştirilir; rapor, ayrıştırmadan sonra sıralamaları gerçek referanslara geri eşler.
|
||||
Aday çalıştırmalar varsayılan olarak `high` düşünme düzeyini, bunu destekleyen OpenAI modelleri içinse
|
||||
`xhigh` düzeyini kullanır. Belirli bir adayı satır içinde geçersiz kılmak için
|
||||
`--model provider/model,thinking=<level>` kullanın. `--thinking <level>` hâlâ genel bir
|
||||
yedek ayar belirler ve eski `--model-thinking <provider/model=level>` biçimi uyumluluk için
|
||||
korunur.
|
||||
OpenAI aday referansları varsayılan olarak hızlı modu kullanır; böylece sağlayıcının desteklediği
|
||||
yerlerde öncelikli işleme kullanılır. Tek bir aday veya değerlendirme modeli için geçersiz kılma
|
||||
gerekiyorsa satır içinde `,fast`, `,no-fast` veya `,fast=false` ekleyin. Hızlı modu her aday model için
|
||||
zorla etkinleştirmek istediğinizde yalnızca `--fast` geçin. Aday ve değerlendirme süreleri,
|
||||
karşılaştırmalı analiz için rapora kaydedilir; ancak değerlendirme istemleri açıkça
|
||||
her transkripti ve çalışma durumunu alır, ancak aday ref'leri
|
||||
`candidate-01` gibi nötr etiketlerle değiştirilir; rapor ayrıştırmadan sonra sıralamaları gerçek ref'lere geri eşler.
|
||||
Aday çalıştırmalar varsayılan olarak `high` thinking kullanır; bunu destekleyen OpenAI modelleri için
|
||||
`xhigh` kullanılır. Belirli bir adayı satır içinde
|
||||
`--model provider/model,thinking=<level>` ile geçersiz kılın. `--thinking <level>` hâlâ
|
||||
genel bir yedek değer ayarlar ve eski `--model-thinking <provider/model=level>` biçimi
|
||||
uyumluluk için korunur.
|
||||
OpenAI aday ref'leri varsayılan olarak fast mode kullanır; böylece sağlayıcının bunu desteklediği yerlerde
|
||||
öncelikli işleme kullanılır. Tek bir aday veya değerlendirici için geçersiz kılma gerektiğinde satır içinde
|
||||
`,fast`, `,no-fast` veya `,fast=false` ekleyin. Fast mode'u her aday model için
|
||||
zorla açmak istediğinizde yalnızca `--fast` geçin. Aday ve değerlendirici süreleri
|
||||
kıyaslama analizi için rapora kaydedilir, ancak değerlendirici istemleri açıkça
|
||||
hıza göre sıralama yapılmamasını söyler.
|
||||
Aday ve değerlendirme modeli çalıştırmalarının her ikisi de varsayılan olarak eşzamanlılık 16 ile gelir.
|
||||
Sağlayıcı sınırları veya yerel gateway yükü çalıştırmayı fazla gürültülü hâle getiriyorsa
|
||||
`--concurrency` veya `--judge-concurrency` değerini düşürün.
|
||||
Hiç aday `--model` geçirilmediğinde, karakter değerlendirmesi varsayılan olarak
|
||||
Aday ve değerlendirici model çalıştırmalarının her ikisi de varsayılan olarak 16 eşzamanlılıkla çalışır.
|
||||
Sağlayıcı sınırları veya yerel gateway
|
||||
yükü bir çalıştırmayı fazla gürültülü hale getiriyorsa `--concurrency` veya `--judge-concurrency` değerini düşürün.
|
||||
Aday `--model` geçilmediğinde character eval varsayılan olarak
|
||||
`openai/gpt-5.4`, `openai/gpt-5.2`, `openai/gpt-5`, `anthropic/claude-opus-4-6`,
|
||||
`anthropic/claude-sonnet-4-6`, `zai/glm-5.1`,
|
||||
`moonshot/kimi-k2.5` ve
|
||||
`google/gemini-3.1-pro-preview` kullanır.
|
||||
Hiç `--judge-model` geçirilmediğinde, değerlendirme modelleri varsayılan olarak
|
||||
Değerlendirici `--judge-model` geçilmediğinde değerlendiriciler varsayılan olarak
|
||||
`openai/gpt-5.4,thinking=xhigh,fast` ve
|
||||
`anthropic/claude-opus-4-6,thinking=high` olur.
|
||||
|
||||
|
||||
@ -1,28 +1,28 @@
|
||||
---
|
||||
read_when:
|
||||
- Modelleri kendi GPU kutunuzdan sunmak istiyorsunuz
|
||||
- LM Studio veya OpenAI uyumlu bir proxy'yi yapılandırıyorsunuz
|
||||
- En güvenli yerel model rehberliğine ihtiyacınız var
|
||||
summary: OpenClaw'u yerel LLM'lerde çalıştırın (LM Studio, vLLM, LiteLLM, özel OpenAI uç noktaları)
|
||||
- Modelleri kendi GPU makinenizden sunmak istiyorsunuz
|
||||
- LM Studio’yu veya OpenAI uyumlu bir proxy’yi yapılandırıyorsunuz
|
||||
- En güvenli yerel model yönlendirmesine ihtiyacınız var
|
||||
summary: OpenClaw'ı yerel LLM'lerde çalıştırın (LM Studio, vLLM, LiteLLM, özel OpenAI uç noktaları)
|
||||
title: Yerel Modeller
|
||||
x-i18n:
|
||||
generated_at: "2026-04-08T02:14:39Z"
|
||||
generated_at: "2026-04-13T08:50:44Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: d619d72b0e06914ebacb7e9f38b746caf1b9ce8908c9c6638c3acdddbaa025e8
|
||||
source_hash: 3ecb61b3e6e34d3666f9b688cd694d92c5fb211cf8c420fa876f7ccf5789154a
|
||||
source_path: gateway/local-models.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Yerel modeller
|
||||
|
||||
Yerel kullanım mümkündür, ancak OpenClaw geniş bağlam ve istem enjeksiyonuna karşı güçlü savunmalar bekler. Küçük kartlar bağlamı kısaltır ve güvenliği sızdırır. Yüksek hedefleyin: **≥2 tam donanımlı Mac Studio veya eşdeğer GPU sistemi (~$30k+)**. Tek bir **24 GB** GPU yalnızca daha hafif istemlerde ve daha yüksek gecikmeyle işe yarar. Çalıştırabildiğiniz **en büyük / tam boyutlu model varyantını** kullanın; aşırı nicemlenmiş veya “küçük” checkpoint'ler istem enjeksiyonu riskini artırır (bkz. [Security](/tr/gateway/security)).
|
||||
Yerel kullanım mümkündür, ancak OpenClaw büyük bağlam ve prompt injection’a karşı güçlü savunmalar bekler. Küçük kartlar bağlamı kırpar ve güvenliği zayıflatır. Hedefinizi yüksek tutun: **en az 2 tam donanımlı Mac Studio veya eşdeğer GPU sistemi (~30 bin $+)**. Tek bir **24 GB** GPU, yalnızca daha hafif prompt’larda ve daha yüksek gecikmeyle çalışır. Çalıştırabildiğiniz **en büyük / tam boyutlu model varyantını kullanın**; agresif biçimde kuantize edilmiş veya “small” checkpoint’ler prompt injection riskini artırır (bkz. [Güvenlik](/tr/gateway/security)).
|
||||
|
||||
En düşük sürtünmeli yerel kurulum istiyorsanız, [Ollama](/tr/providers/ollama) ve `openclaw onboard` ile başlayın. Bu sayfa, daha üst düzey yerel yığınlar ve özel OpenAI uyumlu yerel sunucular için görüşlü rehberdir.
|
||||
En düşük sürtünmeli yerel kurulum istiyorsanız, [LM Studio](/tr/providers/lmstudio) veya [Ollama](/tr/providers/ollama) ile başlayın ve `openclaw onboard` kullanın. Bu sayfa, daha üst seviye yerel yığınlar ve özel OpenAI uyumlu yerel sunucular için görüş odaklı rehberdir.
|
||||
|
||||
## Önerilen: LM Studio + büyük yerel model (Responses API)
|
||||
|
||||
Şu anki en iyi yerel yığın. LM Studio içinde büyük bir model yükleyin (örneğin tam boyutlu bir Qwen, DeepSeek veya Llama derlemesi), yerel sunucuyu etkinleştirin (varsayılan `http://127.0.0.1:1234`) ve akıl yürütmeyi son metinden ayrı tutmak için Responses API kullanın.
|
||||
Şu anda en iyi yerel yığın. LM Studio’da büyük bir model yükleyin (örneğin tam boyutlu bir Qwen, DeepSeek veya Llama derlemesi), yerel sunucuyu etkinleştirin (varsayılan `http://127.0.0.1:1234`) ve akıl yürütmeyi nihai metinden ayrı tutmak için Responses API kullanın.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -59,18 +59,18 @@ En düşük sürtünmeli yerel kurulum istiyorsanız, [Ollama](/tr/providers/oll
|
||||
}
|
||||
```
|
||||
|
||||
**Kurulum kontrol listesi**
|
||||
**Kurulum denetim listesi**
|
||||
|
||||
- LM Studio'yu yükleyin: [https://lmstudio.ai](https://lmstudio.ai)
|
||||
- LM Studio içinde **mevcut en büyük model derlemesini** indirin (“small”/yoğun biçimde nicemlenmiş varyantlardan kaçının), sunucuyu başlatın ve `http://127.0.0.1:1234/v1/models` içinde listelendiğini doğrulayın.
|
||||
- `my-local-model` değerini LM Studio'da gösterilen gerçek model kimliğiyle değiştirin.
|
||||
- LM Studio’yu kurun: [https://lmstudio.ai](https://lmstudio.ai)
|
||||
- LM Studio’da, **mevcut en büyük model derlemesini** indirin (“small”/ağır kuantize edilmiş varyantlardan kaçının), sunucuyu başlatın ve `http://127.0.0.1:1234/v1/models` çıktısında listelendiğini doğrulayın.
|
||||
- `my-local-model` değerini LM Studio’da gösterilen gerçek model kimliğiyle değiştirin.
|
||||
- Modeli yüklü tutun; soğuk yükleme başlangıç gecikmesi ekler.
|
||||
- LM Studio derlemeniz farklıysa `contextWindow`/`maxTokens` değerlerini ayarlayın.
|
||||
- WhatsApp için yalnızca son metnin gönderilmesi amacıyla Responses API'ye bağlı kalın.
|
||||
- WhatsApp için yalnızca nihai metnin gönderilmesi amacıyla Responses API kullanın.
|
||||
|
||||
Yerelde çalışırken bile barındırılan modelleri yapılandırılmış tutun; yedeklerin kullanılabilir kalması için `models.mode: "merge"` kullanın.
|
||||
Yerelde çalıştırıyor olsanız bile barındırılan modelleri yapılandırılmış tutun; geri dönüşlerin kullanılabilir kalması için `models.mode: "merge"` kullanın.
|
||||
|
||||
### Hibrit yapılandırma: barındırılan birincil, yerel yedek
|
||||
### Hibrit yapılandırma: barındırılan birincil, yerel geri dönüş
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -111,18 +111,18 @@ Yerelde çalışırken bile barındırılan modelleri yapılandırılmış tutun
|
||||
}
|
||||
```
|
||||
|
||||
### Önce yerel, barındırılan güvenlik ağıyla
|
||||
### Yerel öncelikli, barındırılan güvenlik ağıyla
|
||||
|
||||
Birincil ve yedek sırasını değiştirin; yerel kutu devre dışı kaldığında Sonnet veya Opus'a geri dönebilmek için aynı sağlayıcı bloğunu ve `models.mode: "merge"` ayarını koruyun.
|
||||
Birincil ve geri dönüş sırasını değiştirin; yerel makine devre dışı kaldığında Sonnet veya Opus’a geri dönebilmek için aynı sağlayıcı bloğunu ve `models.mode: "merge"` ayarını koruyun.
|
||||
|
||||
### Bölgesel barındırma / veri yönlendirme
|
||||
|
||||
- Barındırılan MiniMax/Kimi/GLM varyantları OpenRouter üzerinde bölgeye sabitlenmiş uç noktalarla da vardır (ör. ABD'de barındırılan). Trafiği seçtiğiniz yargı alanında tutarken Anthropic/OpenAI yedeklerini de kullanabilmek için orada bölgesel varyantı seçin ve `models.mode: "merge"` kullanmaya devam edin.
|
||||
- Yalnızca yerel kullanım, gizlilik açısından en güçlü yoldur; barındırılan bölgesel yönlendirme, sağlayıcı özelliklerine ihtiyaç duyduğunuz ama veri akışı üzerinde kontrol istediğiniz durumlarda orta yoldur.
|
||||
- Barındırılan MiniMax/Kimi/GLM varyantları, bölgeye sabitlenmiş uç noktalarla OpenRouter üzerinde de bulunur (ör. ABD’de barındırılan). Trafiği seçtiğiniz yargı alanında tutmak için oradaki bölgesel varyantı seçin; yine de Anthropic/OpenAI geri dönüşleri için `models.mode: "merge"` kullanın.
|
||||
- Yalnızca yerel kullanım en güçlü gizlilik yoludur; sağlayıcı özelliklerine ihtiyaç duyuyor ama veri akışı üzerinde kontrol istiyorsanız, barındırılan bölgesel yönlendirme orta yoldur.
|
||||
|
||||
## Diğer OpenAI uyumlu yerel proxy'ler
|
||||
## Diğer OpenAI uyumlu yerel proxy’ler
|
||||
|
||||
vLLM, LiteLLM, OAI-proxy veya özel gateway'ler, OpenAI tarzı bir `/v1` uç noktası sunuyorlarsa çalışır. Yukarıdaki sağlayıcı bloğunu kendi uç noktanız ve model kimliğinizle değiştirin:
|
||||
vLLM, LiteLLM, OAI-proxy veya özel gateway’ler, OpenAI tarzı bir `/v1` uç noktası sunuyorlarsa çalışır. Yukarıdaki sağlayıcı bloğunu kendi uç noktanız ve model kimliğinizle değiştirin:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -150,25 +150,25 @@ vLLM, LiteLLM, OAI-proxy veya özel gateway'ler, OpenAI tarzı bir `/v1` uç nok
|
||||
}
|
||||
```
|
||||
|
||||
Barındırılan modellerin yedek olarak kullanılabilir kalması için `models.mode: "merge"` kullanmaya devam edin.
|
||||
Barındırılan modellerin geri dönüş olarak kullanılabilir kalması için `models.mode: "merge"` ayarını koruyun.
|
||||
|
||||
Yerel/proxy'lenmiş `/v1` arka uçları için davranış notu:
|
||||
Yerel/proxy’lenmiş `/v1` arka uçları için davranış notu:
|
||||
|
||||
- OpenClaw bunları yerel OpenAI uç noktaları olarak değil, proxy tarzı OpenAI uyumlu rotalar olarak ele alır
|
||||
- yerel OpenAI'ye özgü istek şekillendirme burada uygulanmaz: `service_tier` yoktur, Responses `store` yoktur, OpenAI akıl yürütme uyumluluğu yük şekillendirmesi yoktur ve istem önbelleği ipuçları yoktur
|
||||
- gizli OpenClaw atıf başlıkları (`originator`, `version`, `User-Agent`) bu özel proxy URL'lerine eklenmez
|
||||
- OpenClaw bunları yerel OpenAI uç noktaları değil, proxy tarzı OpenAI uyumlu yollar olarak ele alır
|
||||
- yalnızca yerel OpenAI’ye özgü istek şekillendirme burada uygulanmaz: `service_tier` yoktur, Responses `store` yoktur, OpenAI reasoning uyumluluk payload şekillendirmesi yoktur ve prompt önbelleği ipuçları yoktur
|
||||
- gizli OpenClaw ilişkilendirme başlıkları (`originator`, `version`, `User-Agent`) bu özel proxy URL’lerine eklenmez
|
||||
|
||||
Daha katı OpenAI uyumlu arka uçlar için uyumluluk notları:
|
||||
|
||||
- Bazı sunucular Chat Completions üzerinde yapılandırılmış içerik bölümü dizileri değil, yalnızca string `messages[].content` kabul eder. Bu uç noktalar için `models.providers.<provider>.models[].compat.requiresStringContent: true` ayarlayın.
|
||||
- Daha küçük veya daha katı bazı yerel arka uçlar, özellikle araç şemaları dahil edildiğinde, OpenClaw'un tam ajan çalışma zamanı istem şekliyle kararsız olabilir. Arka uç küçük doğrudan `/v1/chat/completions` çağrılarında çalışıyor ancak normal OpenClaw ajan turlarında başarısız oluyorsa, önce `models.providers.<provider>.models[].compat.supportsTools: false` deneyin.
|
||||
- Arka uç hâlâ yalnızca daha büyük OpenClaw çalıştırmalarında başarısız oluyorsa, kalan sorun genellikle OpenClaw'un taşıma katmanı değil, üst akış model/sunucu kapasitesi veya bir arka uç hatasıdır.
|
||||
- Bazı sunucular, Chat Completions içinde yapılandırılmış içerik-parça dizileri yerine yalnızca string `messages[].content` kabul eder. Bu tür uç noktalar için `models.providers.<provider>.models[].compat.requiresStringContent: true` ayarını yapın.
|
||||
- Bazı daha küçük veya daha katı yerel arka uçlar, özellikle araç şemaları dahil edildiğinde OpenClaw’ın tam agent-runtime prompt biçimiyle kararsız çalışır. Arka uç küçük doğrudan `/v1/chat/completions` çağrılarında çalışıyor ama normal OpenClaw agent dönüşlerinde başarısız oluyorsa, önce `models.providers.<provider>.models[].compat.supportsTools: false` deneyin.
|
||||
- Arka uç yalnızca daha büyük OpenClaw çalıştırmalarında hâlâ başarısız oluyorsa, kalan sorun genellikle OpenClaw’ın taşıma katmanı değil, yukarı akış model/sunucu kapasitesi veya bir arka uç hatasıdır.
|
||||
|
||||
## Sorun giderme
|
||||
|
||||
- Gateway proxy'ye ulaşabiliyor mu? `curl http://127.0.0.1:1234/v1/models`.
|
||||
- LM Studio modeli kaldırılmış mı? Yeniden yükleyin; soğuk başlangıç yaygın bir “takılı kalma” nedenidir.
|
||||
- Bağlam hataları mı var? `contextWindow` değerini düşürün veya sunucu sınırınızı artırın.
|
||||
- OpenAI uyumlu sunucu `messages[].content ... expected a string` döndürüyor mu? Bu model girdisine `compat.requiresStringContent: true` ekleyin.
|
||||
- Doğrudan küçük `/v1/chat/completions` çağrıları çalışıyor ama `openclaw infer model run` Gemma veya başka bir yerel modelde başarısız mı oluyor? Önce `compat.supportsTools: false` ile araç şemalarını devre dışı bırakın, sonra yeniden test edin. Sunucu hâlâ yalnızca daha büyük OpenClaw istemlerinde çöküyorsa, bunu üst akış sunucu/model sınırlaması olarak değerlendirin.
|
||||
- Güvenlik: yerel modeller sağlayıcı tarafı filtreleri atlar; istem enjeksiyonunun etki alanını sınırlamak için ajanları dar tutun ve sıkıştırmayı açık bırakın.
|
||||
- Gateway proxy’ye ulaşabiliyor mu? `curl http://127.0.0.1:1234/v1/models`.
|
||||
- LM Studio modeli yükten mi düştü? Yeniden yükleyin; soğuk başlangıç, yaygın bir “takılı kalma” nedenidir.
|
||||
- Bağlam hataları mı alıyorsunuz? `contextWindow` değerini düşürün veya sunucu sınırınızı yükseltin.
|
||||
- OpenAI uyumlu sunucu `messages[].content ... expected a string` mı döndürüyor? O model girdisine `compat.requiresStringContent: true` ekleyin.
|
||||
- Doğrudan küçük `/v1/chat/completions` çağrıları çalışıyor ama `openclaw infer model run` Gemma veya başka bir yerel modelde başarısız mı oluyor? Önce `compat.supportsTools: false` ile araç şemalarını devre dışı bırakın, sonra yeniden test edin. Sunucu yine yalnızca daha büyük OpenClaw prompt’larında çöküyorsa, bunu yukarı akış sunucu/model sınırlaması olarak değerlendirin.
|
||||
- Güvenlik: yerel modeller sağlayıcı tarafı filtreleri atlar; prompt injection etki alanını sınırlamak için agent’ları dar kapsamlı tutun ve Compaction özelliğini açık bırakın.
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,28 +1,27 @@
|
||||
---
|
||||
read_when:
|
||||
- Bir model sağlayıcısı seçmek istiyorsunuz
|
||||
- Desteklenen LLM arka uçlarına dair hızlı bir genel bakışa ihtiyacınız var
|
||||
- Desteklenen LLM arka uçlarına hızlı bir genel bakışa ihtiyacınız var
|
||||
summary: OpenClaw tarafından desteklenen model sağlayıcıları (LLM'ler)
|
||||
title: Sağlayıcı Dizini
|
||||
x-i18n:
|
||||
generated_at: "2026-04-08T02:17:27Z"
|
||||
generated_at: "2026-04-13T08:50:46Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: e7bee5528b7fc9a982b3d0eaa4930cb77f7bded19a47aec00572b6fcbd823a70
|
||||
source_hash: 3bc682d008119719826f71f74959ab32bedf14214459f5e6ac9cb70371d3c540
|
||||
source_path: providers/index.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Model Sağlayıcıları
|
||||
|
||||
OpenClaw birçok LLM sağlayıcısını kullanabilir. Bir sağlayıcı seçin, kimlik doğrulamasını yapın, ardından
|
||||
varsayılan modeli `provider/model` olarak ayarlayın.
|
||||
OpenClaw birçok LLM sağlayıcısını kullanabilir. Bir sağlayıcı seçin, kimlik doğrulaması yapın, ardından varsayılan modeli `provider/model` olarak ayarlayın.
|
||||
|
||||
Sohbet kanalı belgelerini mi arıyorsunuz (WhatsApp/Telegram/Discord/Slack/Mattermost (eklenti)/vb.)? [Kanallar](/tr/channels) bölümüne bakın.
|
||||
Sohbet kanalı belgelerini mi arıyorsunuz (WhatsApp/Telegram/Discord/Slack/Mattermost (Plugin)/vb.)? [Kanallar](/tr/channels) bölümüne bakın.
|
||||
|
||||
## Hızlı başlangıç
|
||||
|
||||
1. Sağlayıcıyla kimlik doğrulaması yapın (genellikle `openclaw onboard` aracılığıyla).
|
||||
1. Sağlayıcıda kimlik doğrulaması yapın (genellikle `openclaw onboard` aracılığıyla).
|
||||
2. Varsayılan modeli ayarlayın:
|
||||
|
||||
```json5
|
||||
@ -51,7 +50,8 @@ Sohbet kanalı belgelerini mi arıyorsunuz (WhatsApp/Telegram/Discord/Slack/Matt
|
||||
- [Hugging Face (Inference)](/tr/providers/huggingface)
|
||||
- [inferrs (yerel modeller)](/tr/providers/inferrs)
|
||||
- [Kilocode](/tr/providers/kilocode)
|
||||
- [LiteLLM (birleşik gateway)](/tr/providers/litellm)
|
||||
- [LiteLLM (birleşik ağ geçidi)](/tr/providers/litellm)
|
||||
- [LM Studio (yerel modeller)](/tr/providers/lmstudio)
|
||||
- [MiniMax](/tr/providers/minimax)
|
||||
- [Mistral](/tr/providers/mistral)
|
||||
- [Moonshot AI (Kimi + Kimi Coding)](/tr/providers/moonshot)
|
||||
@ -81,9 +81,9 @@ Sohbet kanalı belgelerini mi arıyorsunuz (WhatsApp/Telegram/Discord/Slack/Matt
|
||||
## Paylaşılan genel bakış sayfaları
|
||||
|
||||
- [Ek paketlenmiş varyantlar](/tr/providers/models#additional-bundled-provider-variants) - Anthropic Vertex, Copilot Proxy ve Gemini CLI OAuth
|
||||
- [Görüntü Oluşturma](/tr/tools/image-generation) - Paylaşılan `image_generate` aracı, sağlayıcı seçimi ve yük devretme
|
||||
- [Müzik Oluşturma](/tr/tools/music-generation) - Paylaşılan `music_generate` aracı, sağlayıcı seçimi ve yük devretme
|
||||
- [Video Oluşturma](/tr/tools/video-generation) - Paylaşılan `video_generate` aracı, sağlayıcı seçimi ve yük devretme
|
||||
- [Görüntü Oluşturma](/tr/tools/image-generation) - Paylaşılan `image_generate` aracı, sağlayıcı seçimi ve devretme
|
||||
- [Müzik Oluşturma](/tr/tools/music-generation) - Paylaşılan `music_generate` aracı, sağlayıcı seçimi ve devretme
|
||||
- [Video Oluşturma](/tr/tools/video-generation) - Paylaşılan `video_generate` aracı, sağlayıcı seçimi ve devretme
|
||||
|
||||
## Transkripsiyon sağlayıcıları
|
||||
|
||||
@ -91,7 +91,6 @@ Sohbet kanalı belgelerini mi arıyorsunuz (WhatsApp/Telegram/Discord/Slack/Matt
|
||||
|
||||
## Topluluk araçları
|
||||
|
||||
- [Claude Max API Proxy](/tr/providers/claude-max-api-proxy) - Claude abonelik kimlik bilgileri için topluluk proxy'si (kullanmadan önce Anthropic ilke/şartlarını doğrulayın)
|
||||
- [Claude Max API Proxy](/tr/providers/claude-max-api-proxy) - Claude abonelik kimlik bilgileri için topluluk proxy'si (kullanmadan önce Anthropic ilkesini/şartlarını doğrulayın)
|
||||
|
||||
Tam sağlayıcı kataloğu (xAI, Groq, Mistral vb.) ve gelişmiş yapılandırma için
|
||||
[Model sağlayıcıları](/tr/concepts/model-providers) bölümüne bakın.
|
||||
Tam sağlayıcı kataloğu (xAI, Groq, Mistral vb.) ve gelişmiş yapılandırma için [Model sağlayıcıları](/tr/concepts/model-providers) bölümüne bakın.
|
||||
|
||||
166
docs/tr/providers/lmstudio.md
Normal file
166
docs/tr/providers/lmstudio.md
Normal file
@ -0,0 +1,166 @@
|
||||
---
|
||||
read_when:
|
||||
- OpenClaw'ı LM Studio aracılığıyla açık kaynak modellerle çalıştırmak istiyorsunuz
|
||||
- LM Studio'yu kurmak ve yapılandırmak istiyorsunuz
|
||||
summary: OpenClaw'ı LM Studio ile çalıştırın
|
||||
title: LM Studio
|
||||
x-i18n:
|
||||
generated_at: "2026-04-13T08:50:44Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 11264584e8277260d4215feb7c751329ce04f59e9228da1c58e147c21cd9ac2c
|
||||
source_path: providers/lmstudio.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# LM Studio
|
||||
|
||||
LM Studio, açık ağırlıklı modelleri kendi donanımınızda çalıştırmak için kullanıcı dostu ama güçlü bir uygulamadır. `llama.cpp` (GGUF) veya MLX modellerini (Apple Silicon) çalıştırmanıza olanak tanır. GUI paketi ya da başsız daemon (`llmster`) olarak sunulur. Ürün ve kurulum belgeleri için [lmstudio.ai](https://lmstudio.ai/) adresine bakın.
|
||||
|
||||
## Hızlı başlangıç
|
||||
|
||||
1. LM Studio'yu (masaüstü) veya `llmster`'ı (başsız) kurun, ardından yerel sunucuyu başlatın:
|
||||
|
||||
```bash
|
||||
curl -fsSL https://lmstudio.ai/install.sh | bash
|
||||
```
|
||||
|
||||
2. Sunucuyu başlatın
|
||||
|
||||
Masaüstü uygulamasını başlattığınızdan ya da daemon'u aşağıdaki komutu kullanarak çalıştırdığınızdan emin olun:
|
||||
|
||||
```bash
|
||||
lms daemon up
|
||||
```
|
||||
|
||||
```bash
|
||||
lms server start --port 1234
|
||||
```
|
||||
|
||||
Uygulamayı kullanıyorsanız, sorunsuz bir deneyim için JIT'in etkin olduğundan emin olun. Daha fazla bilgi için [LM Studio JIT and TTL guide](https://lmstudio.ai/docs/developer/core/ttl-and-auto-evict) belgesine bakın.
|
||||
|
||||
3. OpenClaw, bir LM Studio token değeri gerektirir. `LM_API_TOKEN` değişkenini ayarlayın:
|
||||
|
||||
```bash
|
||||
export LM_API_TOKEN="your-lm-studio-api-token"
|
||||
```
|
||||
|
||||
LM Studio kimlik doğrulaması devre dışıysa, boş olmayan herhangi bir token değeri kullanın:
|
||||
|
||||
```bash
|
||||
export LM_API_TOKEN="placeholder-key"
|
||||
```
|
||||
|
||||
LM Studio kimlik doğrulaması kurulum ayrıntıları için [LM Studio Authentication](https://lmstudio.ai/docs/developer/core/authentication) belgesine bakın.
|
||||
|
||||
4. Onboarding'i çalıştırın ve `LM Studio` seçeneğini seçin:
|
||||
|
||||
```bash
|
||||
openclaw onboard
|
||||
```
|
||||
|
||||
5. Onboarding sırasında, LM Studio modelinizi seçmek için `Default model` istemini kullanın.
|
||||
|
||||
Bunu daha sonra da ayarlayabilir veya değiştirebilirsiniz:
|
||||
|
||||
```bash
|
||||
openclaw models set lmstudio/qwen/qwen3.5-9b
|
||||
```
|
||||
|
||||
LM Studio model anahtarları `author/model-name` biçimini izler (ör. `qwen/qwen3.5-9b`). OpenClaw
|
||||
model başvuruları sağlayıcı adını başa ekler: `lmstudio/qwen/qwen3.5-9b`. Bir modelin tam anahtarını
|
||||
`curl http://localhost:1234/api/v1/models` komutunu çalıştırıp `key` alanına bakarak bulabilirsiniz.
|
||||
|
||||
## Etkileşimsiz onboarding
|
||||
|
||||
Kurulumu betiklerle yapmak istediğinizde etkileşimsiz onboarding kullanın (CI, sağlama, uzak önyükleme):
|
||||
|
||||
```bash
|
||||
openclaw onboard \
|
||||
--non-interactive \
|
||||
--accept-risk \
|
||||
--auth-choice lmstudio
|
||||
```
|
||||
|
||||
Ya da API anahtarıyla birlikte temel URL'yi veya modeli belirtin:
|
||||
|
||||
```bash
|
||||
openclaw onboard \
|
||||
--non-interactive \
|
||||
--accept-risk \
|
||||
--auth-choice lmstudio \
|
||||
--custom-base-url http://localhost:1234/v1 \
|
||||
--lmstudio-api-key "$LM_API_TOKEN" \
|
||||
--custom-model-id qwen/qwen3.5-9b
|
||||
```
|
||||
|
||||
`--custom-model-id`, LM Studio tarafından döndürülen model anahtarını alır (ör. `qwen/qwen3.5-9b`);
|
||||
`lmstudio/` sağlayıcı öneki olmadan.
|
||||
|
||||
Etkileşimsiz onboarding, `--lmstudio-api-key` gerektirir (veya ortam değişkenlerinde `LM_API_TOKEN`).
|
||||
Kimlik doğrulaması olmayan LM Studio sunucularında, boş olmayan herhangi bir token değeri işe yarar.
|
||||
|
||||
`--custom-api-key` uyumluluk için desteklenmeye devam eder, ancak LM Studio için tercih edilen seçenek `--lmstudio-api-key`'dir.
|
||||
|
||||
Bu işlem `models.providers.lmstudio` yazar, varsayılan modeli
|
||||
`lmstudio/<custom-model-id>` olarak ayarlar ve `lmstudio:default` kimlik doğrulama profilini yazar.
|
||||
|
||||
Etkileşimli kurulum, isteğe bağlı tercih edilen yükleme bağlamı uzunluğu isteyebilir ve bunu yapılandırmaya kaydettiği keşfedilen LM Studio modelleri genelinde uygular.
|
||||
|
||||
## Yapılandırma
|
||||
|
||||
### Açık yapılandırma
|
||||
|
||||
```json5
|
||||
{
|
||||
models: {
|
||||
providers: {
|
||||
lmstudio: {
|
||||
baseUrl: "http://localhost:1234/v1",
|
||||
apiKey: "${LM_API_TOKEN}",
|
||||
api: "openai-completions",
|
||||
models: [
|
||||
{
|
||||
id: "qwen/qwen3-coder-next",
|
||||
name: "Qwen 3 Coder Next",
|
||||
reasoning: false,
|
||||
input: ["text"],
|
||||
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
|
||||
contextWindow: 128000,
|
||||
maxTokens: 8192,
|
||||
},
|
||||
],
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
## Sorun giderme
|
||||
|
||||
### LM Studio algılanmıyor
|
||||
|
||||
LM Studio'nun çalıştığından ve `LM_API_TOKEN` değişkenini ayarladığınızdan emin olun (kimlik doğrulaması olmayan sunucular için boş olmayan herhangi bir token değeri işe yarar):
|
||||
|
||||
```bash
|
||||
# Masaüstü uygulamasıyla başlatın veya başsız olarak:
|
||||
lms server start --port 1234
|
||||
```
|
||||
|
||||
API'ye erişilebildiğini doğrulayın:
|
||||
|
||||
```bash
|
||||
curl http://localhost:1234/api/v1/models
|
||||
```
|
||||
|
||||
### Kimlik doğrulama hataları (HTTP 401)
|
||||
|
||||
Kurulum HTTP 401 bildiriyorsa, API anahtarınızı doğrulayın:
|
||||
|
||||
- `LM_API_TOKEN` değerinin LM Studio'da yapılandırılan anahtarla eşleştiğini kontrol edin.
|
||||
- LM Studio kimlik doğrulaması kurulum ayrıntıları için [LM Studio Authentication](https://lmstudio.ai/docs/developer/core/authentication) belgesine bakın.
|
||||
- Sunucunuz kimlik doğrulaması gerektirmiyorsa, `LM_API_TOKEN` için boş olmayan herhangi bir token değeri kullanın.
|
||||
|
||||
### Tam zamanında model yükleme
|
||||
|
||||
LM Studio, modellerin ilk istekte yüklendiği tam zamanında (JIT) model yüklemeyi destekler. `Model not loaded` hatalarından kaçınmak için bunun etkin olduğundan emin olun.
|
||||
@ -1,67 +1,48 @@
|
||||
---
|
||||
read_when:
|
||||
- Hangi özelliklerin ücretli API'leri çağırabileceğini anlamak istiyorsanız
|
||||
- Anahtarları, maliyetleri ve kullanım görünürlüğünü denetlemeniz gerekiyorsa
|
||||
- '`/status` veya `/usage` maliyet raporlamasını açıklıyorsanız'
|
||||
- Hangi özelliklerin ücretli API'leri çağırabileceğini anlamak istiyorsunuz
|
||||
- Anahtarları, maliyetleri ve kullanım görünürlüğünü denetlemeniz gerekiyor
|
||||
- '`/status` veya `/usage` maliyet raporlamasını açıklıyorsunuz'
|
||||
summary: Nelerin para harcayabileceğini, hangi anahtarların kullanıldığını ve kullanımın nasıl görüntüleneceğini denetleyin
|
||||
title: API Kullanımı ve Maliyetler
|
||||
x-i18n:
|
||||
generated_at: "2026-04-07T08:49:21Z"
|
||||
generated_at: "2026-04-13T08:50:45Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: ab6eefcde9ac014df6cdda7aaa77ef48f16936ab12eaa883d9fe69425a31a2dd
|
||||
source_hash: f5077e74d38ef781ac7a72603e9f9e3829a628b95c5a9967915ab0f321565429
|
||||
source_path: reference/api-usage-costs.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# API kullanımı ve maliyetler
|
||||
|
||||
Bu belge, **API anahtarlarını çağırabilen özellikleri** ve maliyetlerinin nerede göründüğünü listeler. Odak noktası,
|
||||
provider kullanımı veya ücretli API çağrıları üretebilen OpenClaw özellikleridir.
|
||||
Bu belge, **API anahtarlarını çağırabilen özellikleri** ve bunların maliyetlerinin nerede göründüğünü listeler. Özellikle provider kullanımı veya ücretli API çağrıları oluşturabilen OpenClaw özelliklerine odaklanır.
|
||||
|
||||
## Maliyetlerin göründüğü yerler (sohbet + CLI)
|
||||
|
||||
**Oturum başına maliyet anlık görüntüsü**
|
||||
**Oturum başına maliyet özeti**
|
||||
|
||||
- `/status`, mevcut oturum modelini, bağlam kullanımını ve son yanıt belirteçlerini gösterir.
|
||||
- Model **API anahtarı kimlik doğrulaması** kullanıyorsa `/status`, son yanıt için **tahmini maliyeti** de gösterir.
|
||||
- Canlı oturum meta verileri seyrekse `/status`, en son transcript kullanım
|
||||
girişinden belirteç/önbellek sayaçlarını ve etkin çalışma zamanı model etiketini
|
||||
geri alabilir. Mevcut sıfır olmayan canlı değerler yine önceliklidir ve
|
||||
saklanan toplamlar eksikse veya daha küçükse prompt boyutlu transcript
|
||||
toplamları kazanabilir.
|
||||
- `/status`, mevcut oturum modelini, bağlam kullanımını ve son yanıt token'larını gösterir.
|
||||
- Model **API anahtarı kimlik doğrulaması** kullanıyorsa, `/status` ayrıca son yanıt için **tahmini maliyeti** de gösterir.
|
||||
- Canlı oturum meta verileri yetersizse, `/status` en son transkript kullanım girişinden token/cache sayaçlarını ve etkin çalışma zamanı model etiketini geri kazanabilir. Mevcut sıfır olmayan canlı değerler yine önceliklidir ve depolanan toplamlar eksikse veya daha küçükse, istem boyutundaki transkript toplamları üstün gelebilir.
|
||||
|
||||
**Mesaj başına maliyet alt bilgisi**
|
||||
**Mesaj başına maliyet altbilgisi**
|
||||
|
||||
- `/usage full`, her yanıta **tahmini maliyet** dahil bir kullanım alt bilgisi ekler (yalnızca API anahtarı).
|
||||
- `/usage tokens`, yalnızca belirteçleri gösterir; abonelik tarzı OAuth/token ve CLI akışları dolar maliyetini gizler.
|
||||
- Gemini CLI notu: CLI JSON çıktısı döndürdüğünde OpenClaw kullanımı
|
||||
`stats` içinden okur, `stats.cached` değerini `cacheRead` olarak normalize eder ve
|
||||
gerektiğinde giriş belirteçlerini `stats.input_tokens - stats.cached` üzerinden türetir.
|
||||
- `/usage full`, her yanıta **tahmini maliyet** de dahil olmak üzere bir kullanım altbilgisi ekler (yalnızca API anahtarı).
|
||||
- `/usage tokens` yalnızca token'ları gösterir; abonelik tarzı OAuth/token ve CLI akışları dolar maliyetini gizler.
|
||||
- Gemini CLI notu: CLI JSON çıktısı döndürdüğünde, OpenClaw kullanımı `stats` içinden okur, `stats.cached` değerini `cacheRead` olarak normalize eder ve gerektiğinde giriş token'larını `stats.input_tokens - stats.cached` üzerinden türetir.
|
||||
|
||||
Anthropic notu: Anthropic personeli bize OpenClaw tarzı Claude CLI kullanımına
|
||||
yeniden izin verildiğini söyledi; bu nedenle OpenClaw, Anthropic yeni bir politika yayımlamadığı sürece
|
||||
Claude CLI yeniden kullanımını ve `claude -p` kullanımını bu entegrasyon için
|
||||
onaylanmış kabul eder. Anthropic hâlâ OpenClaw'ın
|
||||
`/usage full` içinde gösterebileceği mesaj başına dolar tahmini sunmaz.
|
||||
Anthropic notu: Anthropic çalışanları bize OpenClaw tarzı Claude CLI kullanımına yeniden izin verildiğini söyledi, bu nedenle Anthropic yeni bir politika yayımlamadığı sürece OpenClaw, Claude CLI yeniden kullanımını ve `claude -p` kullanımını bu entegrasyon için onaylı kabul eder. Anthropic hâlâ OpenClaw'ın `/usage full` içinde gösterebileceği mesaj başına bir dolar tahmini sunmuyor.
|
||||
|
||||
**CLI kullanım pencereleri (provider kotaları)**
|
||||
|
||||
- `openclaw status --usage` ve `openclaw channels list`, provider **kullanım pencerelerini**
|
||||
gösterir (mesaj başına maliyet değil, kota anlık görüntüleri).
|
||||
- İnsan tarafından okunabilir çıktı, provider'lar arasında `X% left` olarak normalize edilir.
|
||||
- Mevcut kullanım-penceresi provider'ları: Anthropic, GitHub Copilot, Gemini CLI,
|
||||
OpenAI Codex, MiniMax, Xiaomi ve z.ai.
|
||||
- MiniMax notu: ham `usage_percent` / `usagePercent` alanları kalan
|
||||
kotayı ifade eder, bu nedenle OpenClaw bunları göstermeden önce tersine çevirir. Sayı tabanlı alanlar varsa yine
|
||||
öncelik kazanır. Provider `model_remains` döndürürse OpenClaw sohbet-modeli girdisini tercih eder,
|
||||
gerekirse pencere etiketini zaman damgalarından türetir ve
|
||||
plan etiketine model adını dahil eder.
|
||||
- Bu kota pencereleri için kullanım kimlik doğrulaması, mümkün olduğunda provider'a özgü hook'lardan gelir;
|
||||
aksi halde OpenClaw auth profilleri, env veya config içindeki eşleşen OAuth/API anahtarı
|
||||
kimlik bilgilerine geri döner.
|
||||
- `openclaw status --usage` ve `openclaw channels list`, provider **kullanım pencerelerini** gösterir (mesaj başına maliyet değil, kota anlık görüntüleri).
|
||||
- İnsan tarafından okunabilir çıktı, provider'lar arasında `X% kaldı` biçimine normalize edilir.
|
||||
- Mevcut kullanım penceresi provider'ları: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi ve z.ai.
|
||||
- MiniMax notu: ham `usage_percent` / `usagePercent` alanları kalan kotayı ifade eder, bu yüzden OpenClaw bunları görüntülemeden önce tersine çevirir. Sayı tabanlı alanlar mevcut olduğunda yine önceliklidir. Provider `model_remains` döndürürse, OpenClaw sohbet modeli girdisini tercih eder, gerektiğinde pencere etiketini zaman damgalarından türetir ve plan etiketine model adını ekler.
|
||||
- Bu kota pencereleri için kullanım kimlik doğrulaması, mevcut olduğunda provider'a özgü hook'lardan gelir; aksi halde OpenClaw auth profilleri, ortam veya yapılandırmadan eşleşen OAuth/API anahtarı kimlik bilgilerine geri döner.
|
||||
|
||||
Ayrıntılar ve örnekler için bkz. [Token use & costs](/tr/reference/token-use).
|
||||
Ayrıntılar ve örnekler için [Token kullanımı ve maliyetler](/tr/reference/token-use) bölümüne bakın.
|
||||
|
||||
## Anahtarlar nasıl keşfedilir
|
||||
|
||||
@ -69,61 +50,55 @@ OpenClaw kimlik bilgilerini şuralardan alabilir:
|
||||
|
||||
- **Auth profilleri** (ajan başına, `auth-profiles.json` içinde saklanır).
|
||||
- **Ortam değişkenleri** (ör. `OPENAI_API_KEY`, `BRAVE_API_KEY`, `FIRECRAWL_API_KEY`).
|
||||
- **Config** (`models.providers.*.apiKey`, `plugins.entries.*.config.webSearch.apiKey`,
|
||||
- **Yapılandırma** (`models.providers.*.apiKey`, `plugins.entries.*.config.webSearch.apiKey`,
|
||||
`plugins.entries.firecrawl.config.webFetch.apiKey`, `memorySearch.*`,
|
||||
`talk.providers.*.apiKey`).
|
||||
- **Skills** (`skills.entries.<name>.apiKey`), anahtarları skill süreci ortamına aktarabilir.
|
||||
- **Skills** (`skills.entries.<name>.apiKey`); bunlar anahtarları skill süreç ortamına aktarabilir.
|
||||
|
||||
## Anahtar harcayabilen özellikler
|
||||
|
||||
### 1) Çekirdek model yanıtları (sohbet + araçlar)
|
||||
|
||||
Her yanıt veya araç çağrısı, **mevcut model provider**'ını kullanır (OpenAI, Anthropic vb.). Bu,
|
||||
kullanım ve maliyetin birincil kaynağıdır.
|
||||
Her yanıt veya araç çağrısı **mevcut model provider'ını** (OpenAI, Anthropic vb.) kullanır. Bu, kullanım ve maliyetin birincil kaynağıdır.
|
||||
|
||||
Buna, OpenClaw'ın yerel kullanıcı arayüzü dışında yine de faturalandırılan abonelik tarzı barındırılan provider'lar da dahildir;
|
||||
örneğin **OpenAI Codex**, **Alibaba Cloud Model Studio
|
||||
Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan** ve
|
||||
**Extra Usage** etkinleştirilmiş Anthropic OpenClaw Claude-login yolu.
|
||||
Buna, maliyeti yine de OpenClaw'ın yerel arayüzü dışında faturalandırılan abonelik tarzı barındırılan provider'lar da dahildir; örneğin **OpenAI Codex**, **Alibaba Cloud Model Studio Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan** ve **Extra Usage** etkinleştirilmiş Anthropic'in OpenClaw Claude-login yolu.
|
||||
|
||||
Fiyatlandırma yapılandırması için bkz. [Models](/tr/providers/models), gösterim için [Token use & costs](/tr/reference/token-use).
|
||||
Fiyatlandırma yapılandırması için [Models](/tr/providers/models), görüntüleme için [Token kullanımı ve maliyetler](/tr/reference/token-use) bölümüne bakın.
|
||||
|
||||
### 2) Media understanding (ses/görüntü/video)
|
||||
### 2) Medya anlama (ses/görüntü/video)
|
||||
|
||||
Gelen medya, yanıt çalıştırılmadan önce özetlenebilir/transkribe edilebilir. Bu, model/provider API'lerini kullanır.
|
||||
Gelen medya, yanıt çalışmadan önce özetlenebilir veya yazıya dökülebilir. Bu, model/provider API'lerini kullanır.
|
||||
|
||||
- Ses: OpenAI / Groq / Deepgram / Google / Mistral.
|
||||
- Görüntü: OpenAI / OpenRouter / Anthropic / Google / MiniMax / Moonshot / Qwen / Z.AI.
|
||||
- Video: Google / Qwen / Moonshot.
|
||||
|
||||
Bkz. [Media understanding](/tr/nodes/media-understanding).
|
||||
Bkz. [Medya anlama](/tr/nodes/media-understanding).
|
||||
|
||||
### 3) Görüntü ve video üretimi
|
||||
|
||||
Paylaşılan üretim yetenekleri de provider anahtarlarını harcayabilir:
|
||||
Paylaşılan üretim yetenekleri de provider anahtarları harcayabilir:
|
||||
|
||||
- Görüntü üretimi: OpenAI / Google / fal / MiniMax
|
||||
- Video üretimi: Qwen
|
||||
|
||||
Görüntü üretimi,
|
||||
`agents.defaults.imageGenerationModel` ayarlanmamışsa auth destekli varsayılan provider'ı çıkarım yoluyla belirleyebilir. Video üretimi ise şu anda
|
||||
`qwen/wan2.6-t2v` gibi açık bir `agents.defaults.videoGenerationModel` gerektirir.
|
||||
Görüntü üretimi, `agents.defaults.imageGenerationModel` ayarlanmadığında auth destekli varsayılan bir provider'ı çıkarımsayabilir. Video üretimi şu anda `qwen/wan2.6-t2v` gibi açık bir `agents.defaults.videoGenerationModel` gerektirir.
|
||||
|
||||
Bkz. [Image generation](/tr/tools/image-generation), [Qwen Cloud](/tr/providers/qwen)
|
||||
ve [Models](/tr/concepts/models).
|
||||
Bkz. [Image generation](/tr/tools/image-generation), [Qwen Cloud](/tr/providers/qwen) ve [Models](/tr/concepts/models).
|
||||
|
||||
### 4) Bellek gömmeleri + anlamsal arama
|
||||
### 4) Bellek embedding'leri + anlamsal arama
|
||||
|
||||
Anlamsal bellek araması, uzak provider'lar için yapılandırıldığında **embedding API'lerini** kullanır:
|
||||
|
||||
- `memorySearch.provider = "openai"` → OpenAI embeddings
|
||||
- `memorySearch.provider = "gemini"` → Gemini embeddings
|
||||
- `memorySearch.provider = "voyage"` → Voyage embeddings
|
||||
- `memorySearch.provider = "mistral"` → Mistral embeddings
|
||||
- `memorySearch.provider = "ollama"` → Ollama embeddings (yerel/self-hosted; genellikle barındırılan API faturalandırması yoktur)
|
||||
- Yerel gömmeler başarısız olursa uzak provider'a isteğe bağlı geri dönüş
|
||||
- `memorySearch.provider = "openai"` → OpenAI embedding'leri
|
||||
- `memorySearch.provider = "gemini"` → Gemini embedding'leri
|
||||
- `memorySearch.provider = "voyage"` → Voyage embedding'leri
|
||||
- `memorySearch.provider = "mistral"` → Mistral embedding'leri
|
||||
- `memorySearch.provider = "lmstudio"` → LM Studio embedding'leri (yerel/self-hosted)
|
||||
- `memorySearch.provider = "ollama"` → Ollama embedding'leri (yerel/self-hosted; genellikle barındırılan API faturalaması yoktur)
|
||||
- Yerel embedding'ler başarısız olursa uzak bir provider'a isteğe bağlı geri dönüş
|
||||
|
||||
`memorySearch.provider = "local"` ile yerelde tutabilirsiniz (API kullanımı yok).
|
||||
`memorySearch.provider = "local"` ile yerel kalabilirsiniz (API kullanımı yok).
|
||||
|
||||
Bkz. [Memory](/tr/concepts/memory).
|
||||
|
||||
@ -138,51 +113,46 @@ Bkz. [Memory](/tr/concepts/memory).
|
||||
- **Grok (xAI)**: `XAI_API_KEY` veya `plugins.entries.xai.config.webSearch.apiKey`
|
||||
- **Kimi (Moonshot)**: `KIMI_API_KEY`, `MOONSHOT_API_KEY` veya `plugins.entries.moonshot.config.webSearch.apiKey`
|
||||
- **MiniMax Search**: `MINIMAX_CODE_PLAN_KEY`, `MINIMAX_CODING_API_KEY`, `MINIMAX_API_KEY` veya `plugins.entries.minimax.config.webSearch.apiKey`
|
||||
- **Ollama Web Search**: varsayılan olarak anahtarsızdır, ancak erişilebilir bir Ollama ana makinesi ile `ollama signin` gerektirir; ana makine gerektiriyorsa normal Ollama provider bearer auth'unu da yeniden kullanabilir
|
||||
- **Ollama Web Search**: varsayılan olarak anahtar gerektirmez, ancak erişilebilir bir Ollama host'u ve `ollama signin` gerektirir; host gerektirdiğinde normal Ollama provider bearer auth'u da yeniden kullanabilir
|
||||
- **Perplexity Search API**: `PERPLEXITY_API_KEY`, `OPENROUTER_API_KEY` veya `plugins.entries.perplexity.config.webSearch.apiKey`
|
||||
- **Tavily**: `TAVILY_API_KEY` veya `plugins.entries.tavily.config.webSearch.apiKey`
|
||||
- **DuckDuckGo**: anahtarsız geri dönüş (API faturalandırması yoktur, ancak resmî değildir ve HTML tabanlıdır)
|
||||
- **SearXNG**: `SEARXNG_BASE_URL` veya `plugins.entries.searxng.config.webSearch.baseUrl` (anahtarsız/self-hosted; barındırılan API faturalandırması yoktur)
|
||||
- **DuckDuckGo**: anahtarsız geri dönüş (API faturası yok, ancak resmî değil ve HTML tabanlı)
|
||||
- **SearXNG**: `SEARXNG_BASE_URL` veya `plugins.entries.searxng.config.webSearch.baseUrl` (anahtarsız/self-hosted; barındırılan API faturalaması yok)
|
||||
|
||||
Eski `tools.web.search.*` provider yolları geçici uyumluluk katmanı üzerinden hâlâ yüklenir, ancak artık önerilen config yüzeyi değildir.
|
||||
Eski `tools.web.search.*` provider yolları, geçici uyumluluk katmanı üzerinden hâlâ yüklenir, ancak artık önerilen yapılandırma yüzeyi değildir.
|
||||
|
||||
**Brave Search ücretsiz kredisi:** Her Brave planı, her ay yenilenen
|
||||
\$5 ücretsiz kredi içerir. Search planı 1.000 istek başına \$5 olduğundan, bu kredi
|
||||
ayda 1.000 isteği ücretsiz karşılar. Beklenmeyen ücretlerden kaçınmak için kullanım sınırınızı Brave panosunda ayarlayın.
|
||||
**Brave Search ücretsiz kredisi:** Her Brave planı, her ay yenilenen \$5 ücretsiz kredi içerir. Search planı 1.000 istek başına \$5 tutarındadır, bu nedenle kredi ek ücret olmadan ayda 1.000 isteği kapsar. Beklenmedik ücretlerden kaçınmak için kullanım sınırınızı Brave kontrol panelinde ayarlayın.
|
||||
|
||||
Bkz. [Web tools](/tr/tools/web).
|
||||
|
||||
### 5) Web fetch aracı (Firecrawl)
|
||||
### 5) Web getirme aracı (Firecrawl)
|
||||
|
||||
`web_fetch`, API anahtarı mevcut olduğunda **Firecrawl** çağırabilir:
|
||||
Bir API anahtarı mevcut olduğunda `web_fetch`, **Firecrawl** çağırabilir:
|
||||
|
||||
- `FIRECRAWL_API_KEY` veya `plugins.entries.firecrawl.config.webFetch.apiKey`
|
||||
|
||||
Firecrawl yapılandırılmamışsa araç doğrudan fetch + readability kullanımına geri döner (ücretli API yok).
|
||||
Firecrawl yapılandırılmamışsa araç, doğrudan fetch + readability'ye geri döner (ücretli API yok).
|
||||
|
||||
Bkz. [Web tools](/tr/tools/web).
|
||||
|
||||
### 6) Provider kullanım anlık görüntüleri (status/health)
|
||||
### 6) Provider kullanım anlık görüntüleri (durum/sağlık)
|
||||
|
||||
Bazı status komutları, kota pencerelerini veya auth sağlığını göstermek için **provider kullanım uç noktalarını** çağırır.
|
||||
Bunlar genellikle düşük hacimli çağrılardır, ancak yine de provider API'lerine istek yapar:
|
||||
Bazı durum komutları, kota pencerelerini veya auth sağlığını göstermek için **provider kullanım uç noktalarını** çağırır. Bunlar genellikle düşük hacimli çağrılardır ancak yine de provider API'lerine istek atar:
|
||||
|
||||
- `openclaw status --usage`
|
||||
- `openclaw models status --json`
|
||||
|
||||
Bkz. [Models CLI](/cli/models).
|
||||
|
||||
### 7) Compaction koruma özetlemesi
|
||||
### 7) Compaction koruma amaçlı özetleme
|
||||
|
||||
Compaction koruması, oturum geçmişini **mevcut model** kullanarak özetleyebilir; bu da
|
||||
çalıştığında provider API'lerini çağırır.
|
||||
Compaction koruması, oturum geçmişini **mevcut model** kullanarak özetleyebilir; bu da çalıştığında provider API'lerini çağırır.
|
||||
|
||||
Bkz. [Session management + compaction](/tr/reference/session-management-compaction).
|
||||
Bkz. [Oturum yönetimi + compaction](/tr/reference/session-management-compaction).
|
||||
|
||||
### 8) Model tarama / probe
|
||||
### 8) Model tarama / yoklama
|
||||
|
||||
`openclaw models scan`, OpenRouter modellerini probe edebilir ve
|
||||
probe etkin olduğunda `OPENROUTER_API_KEY` kullanır.
|
||||
`openclaw models scan`, OpenRouter modellerini yoklayabilir ve yoklama etkin olduğunda `OPENROUTER_API_KEY` kullanır.
|
||||
|
||||
Bkz. [Models CLI](/cli/models).
|
||||
|
||||
@ -196,7 +166,6 @@ Bkz. [Talk mode](/tr/nodes/talk).
|
||||
|
||||
### 10) Skills (üçüncü taraf API'ler)
|
||||
|
||||
Skills, `skills.entries.<name>.apiKey` içinde `apiKey` saklayabilir. Bir skill bu anahtarı harici
|
||||
API'ler için kullanıyorsa, skill'in provider'ına göre maliyet oluşturabilir.
|
||||
Skills, `skills.entries.<name>.apiKey` içinde `apiKey` saklayabilir. Bir skill bu anahtarı harici API'ler için kullanıyorsa, skill'in provider'ına göre maliyet oluşturabilir.
|
||||
|
||||
Bkz. [Skills](/tr/tools/skills).
|
||||
|
||||
Loading…
Reference in New Issue
Block a user