DeepSeek ile OpenClaw: Kurulum, model kimlikleri ve API maliyetleri

OpenClaw, ayrı olarak yüklenen resmi bir sağlayıcı eklentisi — openclaw plugins install @openclaw/deepseek-provider — aracılığıyla DeepSeek'e ulaşır; sağlayıcı kimliği deepseek, anahtarı DEEPSEEK_API_KEY, OpenAI uyumlu bir API'si ve /v1 taşımayan temel URL'si https://api.deepseek.com bulunur. İlk çalıştırmanızın başarılı olup olmayacağını iki gerçek belirler. DeepSeek'in güncel kataloğunda iki kimlik vardır: deepseek-flash ve deepseek-v4-pro; eski eğitimlerde kullanılan deepseek-chat ve deepseek-reasoner adları 24 Temmuz 2026'da kullanımdan kaldırılmıştır. Ayrıca OpenClaw onboarding işlemi deepseek/deepseek-v4-pro değerini varsayılanınız olarak ayarlar; bu, güncel faturalandırması DeepSeek'in kendi sayfalarında çelişkili olan tek modeldir.

Aram sonuçları bunları birbirine karıştırdığı için yapılandırmadan önce bir ayrım yapalım. GitHub'daki farklı bir OpenClaw kendisini "orijinal Captain Claw (1997) platform oyununun çok platformlu bir C++ yeniden uygulaması" olarak tanımlar; onunla ilgili hiçbir şey burada geçerli değildir. Aracı proje openclaw.ai adresindedir ve docs.openclaw.ai üzerinde belgelenmiştir — documentation.openclaw.ai yalnızca buraya yönlendirdiği için bu ana bilgisayara bağlantı verin.

Her iki projenin belgelediği şekilde yükleyip yapılandırın

# 1. Install the provider plugin — DeepSeek support is not bundled.
openclaw plugins install @openclaw/deepseek-provider

# 2. Interactive: prompts for the key, sets deepseek/deepseek-v4-pro as default.
openclaw onboard --auth-choice deepseek-api-key

# 2b. Or scripted, with the flags OpenClaw documents for a headless install.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk

Eklenti yüklüyken bir temel URL sağlamazsınız: eklenti kendi kataloğunu ve uyumluluk davranışını yayımlar. JSON5 biçiminde en az yapılandırma anahtar ile modelden oluşur.

{
  env: { vars: { DEEPSEEK_API_KEY: "sk-..." } },
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-v4-pro" },
    },
  },
}

OpenClaw, belgelenmiş bir öncelik sırasına göre bir sağlayıcı anahtarını dört ortam değişkeni biçiminden çözümler: en yüksek önceliğe sahip tek bir canlı geçersiz kılma olarak OPENCLAW_LIVE_DEEPSEEK_KEY, ardından virgül veya noktalı virgülle ayrılmış liste olarak DEEPSEEK_API_KEYS, sonra birincil anahtar olarak DEEPSEEK_API_KEY, ardından numaralandırılmış DEEPSEEK_API_KEY_* girdileri (Kontrol Kullanıcı Arayüzü ve anahtarlar, 21 Eylül 2026'da kontrol edilmiştir). Kontrol Kullanıcı Arayüzü'nde Settings, ardından Models seçeneği dosyayı düzenlemeden anahtar ekler veya değiştirir; anahtar materyali auth store'da kalır. Sunucu kurulumundaki tuzak yazım değil kapsamdadır: OpenClaw'un kendi sayfası, Gateway launchd veya systemd altında daemon olarak çalışıyorsa anahtarın bu işlem tarafından görülebilmesi gerektiği konusunda uyarır; örneğin ~/.openclaw/.env içinde veya env.shellEnv aracılığıyla.

Hangi DeepSeek model kimlikleri gerçekten kullanılabilir durumda

Aşağıdaki satırlar tek bir durum yerine üç farklı durum taşır. DeepSeek'in model-listesi referansındaki örnek yanıt tam olarak iki kimlik gösterir: deepseek-flash ve deepseek-v4-pro; OpenClaw'un paketlenmiş kataloğu ise hâlâ dört başvuru sunar.

İki kullanımdan kaldırma bildirimini ayrı tutun; çelişkili gibi görünürler ancak öyle değildirler. OpenClaw, DeepSeek'in deepseek-chat ve deepseek-reasoner modellerini kullanımdan kaldırdığını ve "bu model kimliklerine artık erişilemediğini" belirtir. DeepSeek ise ayrı olarak "eski adlar deepseek-v4-flash ve deepseek-v4-flash-vision-exp hâlâ kabul ediliyor, ancak karşılık gelen modeller kullanımdan kaldırıldı" der. İki farklı ad çifti, iki farklı sonuç. DeepSeek'in Models & Pricing sayfası her iki canlı kimlik için 1M bağlam uzunluğu ve 384K maksimum çıktı verir; OpenClaw'un katalog tablosu da dört başvurusunun tamamında aynı 1.000.000 / 384.000 çiftini taşır.

Çözümlenmemiş olan. DeepSeek'in 10 Eylül 2026 tarihli duyurusu "V4-Pro'yu aşamalı olarak kullanımdan kaldırıyoruz" ve "14 Eylül 2026 saat 04:00 UTC'den itibaren tüm deepseek-v4-pro istekleri V4.1-Flash'a, V4.1-Flash ücretleri üzerinden yönlendirilecek" der. Aynı sürümün değişiklik günlüğü ise bunun tersini söyler: "kullanıcı talebine yanıt olarak, 14 Eylül 2026'dan sonra DeepSeek V4 Pro için API hizmetleri sunmaya devam etmeye karar verdik; faturalandırma yöntemi değişmeden kalacak." Models & Pricing sayfası hâlâ V4 Pro'yu kendine ait daha yüksek ücretlerle listeler ve herhangi bir kullanımdan kaldırma bildirimi içermez. Her ikisi de söz konusu tarihten bir hafta sonra, 21 Eylül 2026'da okundu. Bu sayfa sizi hangisinin ücretlendirdiği konusunda bilgilendirmeyecektir — ilk kurulumdaki varsayılan modeli olduğu gibi bırakmadan önce kendi DeepSeek hesabınızdan doğrulayın ve varsayılanın tam olarak tartışmalı model olduğunu unutmayın.

Token'ların maliyeti ve saatin neden fiyatın bir parçası olduğu

DeepSeek, yoğun ve yoğun olmayan dönem ücretlerini yayımlar; yoğun olmayan dönem ücreti, yoğun dönem ücretinin yarısıdır. Zaman aralığı dardır: "yoğun saatler pazartesiden cumaya, Çin resmî tatilleri hariç, 01:00 - 04:00 ve 06:00 - 10:00 UTC arasındadır. Çin resmî tatilleri dâhil olmak üzere diğer tüm saatler yoğun olmayan dönemdir." Haftanın yedi günü içindeki yedi saat yoğundur; diğer her şey yoğun değildir. Bu nedenle yoğun dönemi sessizce varsayan bir tahmin tipik faturayı olduğundan yüksek gösterir.

21 Eylül 2026'da DeepSeek'in Models & Pricing sayfasından okundu. Flash satırı, "milyon giriş token'ı başına $0,30, milyon çıkış token'ı başına $1,20 ve milyon önbelleğe alınmış giriş token'ı başına $0,006" adlarını veren OpenClaw'un sağlayıcı sayfasıyla bağımsız olarak doğrulanır. V4 Pro satırları yalnızca Models & Pricing sayfasına dayanır ve yukarıdaki çelişkinin altındadır; bu nedenle bunları kesinleşmiş bilgiler olarak değil, alıntılanan değerler olarak değerlendirin.

Önbellek sütunu, bir aracının faturasını değiştiren unsurdur ve oranı alışılmadıktır. deepseek-flash için bir önbellek isabeti, isabetsizlik için $0,30'a karşılık milyon başına $0,006'dır — isabetsizlik oranının yaklaşık ellide biri; başka yerlerde yaygın olan onda birlik oranın çok altındadır. Bu nedenle başka bir sağlayıcıya ilişkin varsayımı buraya taşımayın. DeepSeek'in önbelleğe alma kılavuzu, bu özelliğin "kodlarını değiştirmeye gerek olmadan tüm kullanıcılar için varsayılan olarak etkin olduğunu", isabet için ön ekin tamamen eşleşmesi gerektiğini ve kullanılmayan önbelleğin "genellikle birkaç saat ile birkaç gün içinde" temizlendiğini belirtir. İsabetler ve isabetsizlikler prompt_cache_hit_tokens ve prompt_cache_miss_tokens kullanım alanlarında döner. DeepSeek, önbellek yazma ücreti yayımlamaz ve fiyatlandırma tablosunda önbellek yazma sütunu yoktur; bu, yayımlanmış bir ücretin bulunmadığı anlamına gelir, yazmaların ücretsiz olduğu anlamına değil.

deepseek-flash üzerinde, DeepSeek'in yayımlanmış ücretleriyle örnek bir oturum. 600.000 giriş token'ı gönderen, bunların 450.000'inin ön ek önbelleğine isabet ettiği, 150.000'inin isabet etmediği ve 40.000 çıkış token'ı alan tek bir OpenClaw çalıştırması varsayalım. Yoğun dönemde bu, $0,045 artı $0,0027 artı $0,048, yani $0,096 eder; aynı oturum yoğun olmayan dönemde $0,048 olur. Hiç önbellek isabeti olmayan aynı çalıştırma, yoğun dönemde $0,228 olurdu. Bunlar belirtilen varsayımlar üzerinden yapılan token hesaplarıdır; ölçülmüş görev maliyetleri veya harcama tavanı değildir — en önemli değişken kendi önbellek isabet oranınızdır ve OpenClaw'un uygulama içi değeri bunu kesinleştirmez; çünkü OpenClaw kendi yerel maliyetlerinin tahmini olduğunu belirtir ve faturalandırma için yetkili kaynak olarak DeepSeek'in fiyatlandırma sayfasını gösterir.

Model yeteneği ile istemci araç desteği iki farklı sorudur

Fiyat tablosunun size söyleyemeyeceği kısım budur ve elle yazılmış bir sağlayıcı girdisi yerine eklentiyi kullanmanın pratik nedeni de budur. DeepSeek V4 düşünme oturumlarında, düşünmenin etkin olduğu bir turdan yeniden kullanılan asistan mesajlarının takip isteklerinde reasoning_content içermesi gerekir. OpenClaw'un DeepSeek eklentisi bu alanı otomatik olarak tamamlar; böylece çok turlu araç kullanımı "geçmiş başka bir OpenAI uyumlu sağlayıcıdan (yerleşik reasoning_content desteği olmadan) veya düz bir asistan mesajından gelmiş olsa bile" çalışır ve oturum ortasında sağlayıcı değiştirildikten sonra /new gerekmez. Kullanıcı arayüzündeki None seçimi de dâhil olmak üzere, düşünme kapalıyken OpenClaw thinking: { type: "disabled" } gönderir ve yeniden kullanılan reasoning_content alanlarını gönderilen geçmişten çıkarır. OpenClaw ayrıca hem /think xhigh hem de /think max değerini DeepSeek'in maksimum reasoning_effort değerine eşler.

DeepSeek uyumlu bir uç noktaya yönlendirilen genel bir openai-completions özel sağlayıcı, bu alan doldurma davranışının hiçbirini ve uyumluluk bloğunu kendiniz bildirmediğiniz sürece DeepSeek düşünme biçimini de almaz — OpenClaw'un ds4 sayfası, thinkingFormat: "deepseek" ve supportsReasoningEffort dâhil olmak üzere biçimi gösterir. Bir araç turunun bir kez başarılı olup takip turunda başarısız olmasının olağan açıklaması bu farktır.

Aynı kararda DeepSeek tarafındaki iki sınır da dikkate alınmalıdır. Katı mod araç çağrısı farklı bir temel URL'de, https://api.deepseek.com/beta, bulunur ve her işlevde "strict": true ile "additionalProperties": false gerektirir; eklenti varsayılan olarak buraya yönelmez. Ayrıca DeepSeek'in araç çağrısı kılavuzu, "Chat Completion API'si konuşma ortasına araç çağrıları eklemeyi desteklemez ancak konuşma ortasına system mesajları eklemeyi destekler; araç çağrıları eklemek için Anthropic API'sini veya Responses API'sini kullanın" der — OpenClaw eklentisinin kullandığı uç noktanın bir sınırı ve model sınırlaması değil, belgelenmiş iki alternatifi vardır.

Model desteği konusunda iki kaynak hemfikirdir. DeepSeek'in Models & Pricing sayfasındaki FEATURES sütunu, Tool Calls, JSON Output, Responses API ve Anthropic API özelliklerini hem deepseek-flash hem de deepseek-v4-pro üzerinde destekleniyor olarak işaretler; vision özelliğinde ise ayrım yapar — deepseek-flash üzerinde desteklenir, deepseek-v4-pro üzerinde desteklenmez. OpenClaw, çok turlu araç kullanımının dört başvurusunun tamamında çalıştığını belirtir. Her iki tarafın da belgelemediği şey paralel araç çağrılarıdır; dolayısıyla bu konu gerçekten açıkta kalır ve iki taraftan biri tarafından da yanıtlanmış değildir.

Üç adımda doğrulayın; ardından adlandırmaya değer hatalara geçin

Her katmanı sırayla kontrol edin; çünkü her biri farklı şekilde başarısız olur. İlk olarak katalog: openclaw models list --provider deepseek veya çalışan bir Gateway olmadan eklentinin statik kataloğunu incelemek için openclaw models list --all --provider deepseek, ardından onboarding varsayılanı yerine tartışmasız modeli istiyorsanız openclaw models set deepseek/deepseek-flash. İkinci olarak, önce kısa bir akışsız istem, ardından akışlı bir istem gönderin; kimlik doğrulama veya temel URL sorununun açıkça ortaya çıktığı yer burasıdır. Üçüncü olarak — yalnızca üçüncü adımda — aynı oturumda bir araç çağrısının ardından ikinci bir tur çalıştırın; yukarıda açıklanan reasoning_content yeniden oynatma davranışını sınayan tek adım budur.

404 satırı kendi cümlesini hak eder; çünkü belgelerin sizin için açıklayamadığı tek durum budur. DeepSeek'in hata kodu tablosu 400, 401, 402, 422, 429, 500 ve 503 kodlarını listeler ve 404 içermez; dolayısıyla buradaki 404, DeepSeek hakkında değil yönlendirmeniz hakkında kanıttır. DeepSeek'in bilinmeyen bir model kimliği için gerçekte ne döndürdüğü belgelenmemiştir ve burada test edilmemiştir. Hata referansı, Kunavo'nun kendi uç noktasındaki eşdeğer durum kodlarını kapsar.

Doğrudan, gateway üzerinden, yerel: hangi rota kazanır

Kunavo hiçbir DeepSeek modeli sunmaz. Metin modelleri Claude ve OpenAI aileleridir; bu nedenle Kunavo üzerinden DeepSeek modeline giden bir rota yoktur ve bu sayfa böyle bir rota sunmamaktadır. Aktarılan şey mekanizmadır; DeepSeek'e özel olmaktan ziyade model aileleri arasında tek anahtar kullanmak istediğiniz için bir DeepSeek kurulum sayfasını okuyorsanız bunu bilmek faydalıdır.

Gateway satırı için yapılandırma aynı iki denetimden oluşur. Ya models.providers.<id> değerini baseUrl, apiKey, api: "openai-completions" ve en az her id değerini listeleyen bir models[] dizisiyle bildirin ya da uç noktaya --auth-choice custom-api-key, --custom-base-url ve --custom-model-id ile onboarding yapın. Model başvuruları her zaman provider/model biçimindedir; sessiz başarısızlık, bir modeli agents.defaults.models altında takma ad olarak bildirip models.providers.<provider>.models[] içinde kaydetmemektir — OpenClaw'un özel sağlayıcı referansı, takma adın "tek başına geçersiz kılmaları ne sınırlandırdığını ne de yeni bir çalışma zamanı modeli kaydettiğini" belirtir. Bu rota için Kunavo'nun temel URL'si https://api.kunavo.com/v1 olup tam olarak bir /v1 içerir — DeepSeek'in sonek kullanmama kuralının tersidir ve biri bir sayfadaki değeri diğerinin alanına kopyaladığında 404 oluşmasının en olası kaynağıdır.

Bu alternatifin ölçeğini anlamak için aynı varsayılan oturum biçimini — 600.000 giriş token'ı ve 40.000 çıkış token'ı, önbellek varsayılmadan — güncel Kunavo kataloğu ücretleriyle fiyatlandıralım. Bunlar farklı bir uç noktadaki farklı modellerdir; dolayısıyla bu, yukarıdaki DeepSeek değerleriyle aynı görevin maliyet karşılaştırması değil, biçim karşılaştırmasıdır. Listelenen en ucuz ücret ile bir görevi tamamlamanın en düşük maliyeti ayrı iddialardır ve ikinci iddiayı yalnızca kendi çalıştırmanız kesinleştirir.

Belirtilen varsayımlar üzerinden yapılan örnek token hesabıdır; ölçülmüş görev maliyeti veya fatura tavanı değildir. Kunavo kataloğundaki tutar bir tavan değil, faturalandırma tabanıdır: üst sağlayıcı ücretini bildirdiğinde fatura, katalog maliyeti ile üst sağlayıcı maliyetinin geçerli çarpanla çarpımından büyük olanıdır. Önbellek ücretleri ve harici araçlar bu örneğin dışındadır. Minimum yükleme, ön ödemeli kredi olarak $10 tutarındadır — bu bir finansman minimumudur; görev ücreti veya abonelik değildir. Faturalandırma ayrıntılarına ve önbelleğe alma konularına bakın.

Gerçekte istediğiniz şey bu komşu rotaysa temel URL ve anahtar kurulumuyla ilgili entegrasyonlara genel bakıştan başlayın, ardından ilk çağrı için hızlı başlangıca geçin ve bir anahtara bakiye yüklemeye hazır olduğunuzda Kunavo hesabı oluşturun. Bunu bir uyumluluk sonucu olarak değil, yayımlanmış bir yapılandırma referansı olarak değerlendirin: OpenClaw, Kunavo'nun uç noktasına karşı çalışma zamanında test edilmemiştir. OpenClaw'da kalıp bir model mi seçiyorsunuz? OpenClaw fiyatlandırması ücretsiz yazılımı ölçümlenen faturadan ayırır, OpenClaw için en iyi API rotaları göreve göre karşılaştırır ve OpenAI uyumlu API bu sayfanın sürekli uyardığı temel URL kurallarını kapsar.

Sık sorulan sorular

Yukarıdaki her OpenClaw ve DeepSeek ifadesi, 21 Eylül 2026'da OpenClaw v2026.9.5 temel alınarak bu projelerin kendi belgelerinden ve kayıtlarından okundu; sağlayıcı sayfası, fiyatlandırma sayfası, değişiklik günlüğü, 10 Eylül duyurusu, model-listesi referansı, hata kodu tablosu, hız sınırı sayfası ve özel sağlayıcı kuralları bu sayfa için doğrudan yeniden alındı. Hiçbir şey yüklenmedi, onboarding yapılmadı veya çağrılmadı: OpenClaw çalıştırması yok, api.deepseek.com adresine istek yok ve Kunavo'ya karşı çalışma zamanı testi yok. Kunavo token ücretleri güncel katalogdan alınmıştır; her dolar tutarı ölçülmüş maliyet değil, örnek token hesabıdır.