Gemini ile OpenClaw: model kurulumu, API anahtarları ve maliyet kontrolleri

OpenClaw, Gemini’ye paketlenmiş google eklentisi üzerinden ulaşır: GEMINI_API_KEY veya GOOGLE_API_KEY ayarını yapın, openclaw onboard --auth-choice gemini-api-key komutunu çalıştırın, ardından modeli açıkça ayarlayın — çünkü kimlik doğrulama eklemek varsayılan modelinizi değiştirmez. Çoğu kurulum yazısının gözden kaçırdığı nokta, bir AI Studio anahtarıyla OpenClaw’ın her birinin ayrı kimlik bilgisi, uç noktası ve ücretlendirmesi olan üç ayrı Gemini yüzeyine sahip olmasıdır. (Vertex AI, gcloud Application Default Credentials üzerinden ayrı bir kimlik bilgisi yolu olan dördüncü seçenektir ve burada ele alınmamaktadır.) Sohbeti çalışır hâle getirmek Gemini aramasını etkinleştirmez; Gemini aramasını etkinleştirmek de sohbet rotanızın hiç dokunmadığı bir Google projesinde ücret oluşmasına neden olabilir.

Gemini entegrasyonu ayrı bir kurulum değildir. OpenClaw’ın içinde, paketlenmiş google sağlayıcı eklentisi olarak gelir (resmî sağlayıcı eklentileri, 21 Eylül 2026) ve OpenClaw MIT lisanslıdır; npm üzerinde openclaw@2026.9.5 olarak yayımlanır ve Node >=24.16.0 <25 || >=26.1.0 gerektirir (npm kayıt defteri, 21 Eylül 2026). Yazılım ücretsizdir; aşağıdaki her şey anahtarların maliyetiyle ilgilidir.

Üç Gemini yüzeyi, üç kimlik bilgisi

Öncelik kuralları asıl önemli kısımdır. Gemini web araması önce plugins.entries.google.config.webSearch.apiKey, ardından GEMINI_API_KEY, sonra models.providers.google.apiKey ayarını okur ve özel webSearch.baseUrl, models.providers.google.baseUrl ayarından önce önceliklidir. OpenClaw burada model sağlayıcısı üstbilgilerini devralmayı da reddeder; çünkü bunlar “web araması uç noktasından farklı olabilen model sağlayıcısı uç noktasına aittir” ve Content-Type, x-goog-api-key ile x-goog-api-client sahipliğini arama isteğinde tutar (Gemini arama belgeleri, 21 Eylül 2026). İki rota, kasıtlı olarak bağımsızdır.

Daha eski bir öğreticiyi izlemeye başlamadan önce: OpenClaw, 18 Haziran 2026’da tüketici Gemini CLI’nin Google ile oturum açma erişiminin sona ermesine atıfta bulunarak “yeni Gemini CLI OAuth veya Antigravity OAuth kurulumu sunmadığını” belirtir (sağlayıcı belgeleri). Google’ın 19 Mayıs 2026 tarihli kendi yazısı, Gemini CLI ve Code Assist IDE uzantılarının Google AI Pro ve Ultra abonelerine ve ücretsiz kullanıcılara hizmet vermeyi durduracağını söyler (Google geliştirici blogu). Her iki ifade de CLI ve IDE yüzeyiyle ilgilidir; AI Studio API anahtarlarıyla değil — aşağıdaki API anahtarı yolu kullanılmalıdır.

Gemini API anahtarını ayarlama

# The bundled google plugin reads either name.
export GEMINI_API_KEY="AIza..."   # or GOOGLE_API_KEY

openclaw onboard --auth-choice gemini-api-key

# Auth alone does not change the default model — set it on purpose.
openclaw models list --provider google
openclaw models set google/<id-from-that-list>

Paketlenmiş eklenti, rotasyon için GEMINI_API_KEYS, GEMINI_API_KEY_1 ve GEMINI_API_KEY_2 değerlerini, tek bir geçersiz kılma olarak da OPENCLAW_LIVE_GEMINI_KEY değerini okur (resmî sağlayıcı eklentileri, 21 Eylül 2026). Bunlar google eklentisinin kendi değişkenleri olarak belgelenmiştir; özel sağlayıcı başvurusu, kendi tanımladığınız bir sağlayıcı kimliği için bunları listelemez ve anahtarını apiKey üzerinden ayarlar ($${ENV_VAR} genişletmesi burada gösterilmiştir).

Son satır göründüğünden daha önemlidir. openclaw configure, “bir sağlayıcı eklediğinizde veya yeniden kimlik doğruladığınızda mevcut agents.defaults.model.primary değerini korur” ve openclaw models auth login, --set-default iletilmediği sürece aynı şeyi yapar (hızlı kurallar). Gemini’de kimlik doğrulaması yapıp hâlâ eski modelden yanıt almak beklenen davranıştır, hata değildir.

Hiçbir öğreticiden model kimliği kopyalamayın; buna bu öğretici de dâhil. Yapılandırılmış bir anahtarla OpenClaw, Gemini models.list API’sinden Google AI Studio’nun metin modeli kataloğunu yeniler; böylece yeni varyantlar OpenClaw sürümü yayımlanmadan görünür. Ayrıca OpenClaw’ın kendi sayfaları örnek kimlik konusunda birbirleriyle çelişir: bir yerde google/gemini-3.5-flash, başka bir yerde google/gemini-3.1-flash ve google/gemini-3.1-pro-preview adlandırılır; arama aracı ise varsayılan olarak gemini-3.6-flash kullanır. Tek yetkili kaynak canlı listedir. OpenClaw bazı eski başvuruları da normalleştirir — google/gemini-3.1-pro, google/gemini-3.1-pro-preview olarak “kabul edilir ve normalleştirilir” (resmî sağlayıcı eklentileri) — ve google/gemini-3-pro-preview “2026-03-09 tarihinde kullanımdan kaldırılmıştır”; yerine google/gemini-3.1-pro-preview adı verilir (sağlayıcı belgeleri, 21 Eylül 2026).

Bir Gemini API anahtarı gerçekte neyi ücretlendirir?

Belirteçler ve arama temellendirmesi iki ayrı kalemdir; Google’ın sayfası ilk bakışta bunları tek kalem gibi gösterir. Standart katman Gemini Developer API ücretleri, 1 milyon belirteç başına, Google’ın fiyatlandırma sayfasından alınmıştır (son güncelleme 16 Eylül 2026, okuma 21 Eylül 2026):

Son sütunu iki kez okuyun. OpenClaw’ın varsayılan Gemini web araması modeli olarak gemini-3.6-flash kullanılır; bu, Google’ın ücretsiz katmanında temellendirmesi “Mevcut değil” olan bir Gemini 3.x modelidir — dolayısıyla kullanıma hazır Gemini arama kurulumu, aynı modelin belirteçleri ücretsiz olsa da ücretlendirilen bir proje gerektirir. Birimler de farklıdır: OpenClaw’ın kendisi “Gemini 3 temellendirmesi arama sorgusu başına, Gemini 2.5 temellendirmesi ise istem başına ücretlendirilir” der; Google da şu açıklamayı ekler: “Bir istek, Google Arama’ya bir veya daha fazla sorgu gönderilmesiyle sonuçlanabilir. Gerçekleştirilen her bir arama sorgusu için ücretlendirilirsiniz.” Temellendirme, belirteç maliyetinin üzerine eklenir — “Gemini maliyetleri her zaman geçerlidir” (her iki alıntı da aynı fiyatlandırma sayfasından). Örnek olarak, 6.500 Gemini 3.x arama sorgusu içeren bir ayda bunların 1.500’ü 1.000 başına 14 $ üzerinden ücretlendirilir; bu da herhangi bir belirteçten önce yalnızca arama ücretlerinde $21,00 eder.

Aynı sayfadan iki girdi daha: ücretli katman, %50 maliyet indirimiyle bağlam önbelleğe alma ve Batch API ekler; ayrıca veri kullanımı maddesini değiştirir — ücretsiz katman içeriği “ürünlerimizi geliştirmek için kullanılır”, ücretli katman içeriği ise kullanılmaz. Bu, sürekli çalışan bir asistan için önemlidir. Gemini, OpenClaw’ın arama sağlayıcılarından yalnızca biridir; DuckDuckGo (“Yok (anahtarsız)”), SearXNG (“Yok (kendi sunucunda barındırılan)”) ve Parallel Search (Ücretsiz) (“Yok (ücretsiz Search MCP)”), web araması sağlayıcıları tablosunda anahtarsız seçenekler olarak listelenir (web araması, 21 Eylül 2026). Bu nedenle “Gemini temellendirmesine gerçekten ihtiyacım var mı?” sorusu doğru bir ilk sorudur.

Gemini sohbetini OpenAI uyumlu bir ağ geçidi üzerinden yönlendirme

OpenClaw’ın özel sağlayıcı başvurusu, açık models.providers.<id> girdilerinin “yalnızca varsayılan temel URL’yi, üstbilgileri veya model listesini geçersiz kılmak istediğinizde” kullanılmasını söyler; ağ geçidi yapılandırma başvurusu ise on bir api değeri listeler: openai-completions, openai-responses, openai-chatgpt-responses, anthropic-messages, google-generative-ai, google-vertex, github-copilot, bedrock-converse-stream, ollama, pi-messages ve azure-openai-responses. v2026.9.7 yapılandırma şeması, 25 Eylül 2026’da eklenen on ikinci bir değeri, google-interactions değerini kabul eder. Başvuru bunu henüz listelemez; ancak OpenClaw’ın Google sağlayıcısı sayfası, bunu varsayılan google-generative-ai aktarımına isteğe bağlı bir alternatif olarak belgeler ve Gemini’nin https://generativelanguage.googleapis.com/v1beta altındaki Interactions API’sini kullanır. Kunavo’nun Gemini modellerine, POST /v1/chat/completions üzerindeki OpenAI uyumlu yüzeyi üzerinden ulaşılır (sohbet uç noktası); Kunavo herhangi bir generativelanguage, v1beta veya Interactions uç noktası yayımlamaz. Bu nedenle Google bağdaştırıcılarının hiçbiri ona ulaşamaz; ulaşılabilir rota ayrı bir sağlayıcı kimliğidir ve hiçbir zaman yeniden yönlendirilmiş bir google eklentisi değildir.

{
  "models": {
    "mode": "merge",
    "providers": {
      "kunavo": {
        "baseUrl": "https://api.kunavo.com/v1",
        "apiKey": "${KUNAVO_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "gemini-3-8-flash",
            "name": "Gemini 3.8 Flash",
            "input": [
              "text",
              "image"
            ],
            "contextWindow": 1048576,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "kunavo/gemini-3-8-flash"
      }
    }
  }
}

Buradaki dört ayrıntı kritik öneme sahiptir. Slug tirelidir — Kunavo’nun kimliği gemini-3-8-flash iken Google’ın ve OpenClaw’ın kimlikleri noktalıdır; bunlar farklı dizelerdir. contextWindow, bağlam meta verisi olmayan özel bir modelin 200.000 belirteçlik bütçeye geri dönmesini önlemek için tanımlanır; aksi hâlde Kunavo kataloğunun burada kaydettiği pencerenin çoğu boşa harcanır (1.048.576 belirteç — Google tarafından yayımlanmış bir sınır değil, Kunavo meta verisidir). input, görüntüleri adlandırır; çünkü OpenClaw özel bir modeli varsayılan olarak yalnızca metin olarak kabul eder. cost ise atlanır, bu nedenle OpenClaw’ın yerel tahmini bu rotada varsayılan olarak sıfırdır: 0 $ göstergesi ücretsiz çıkarım değil, eksik meta verisidir.

Bu rotanın nelerden vazgeçtiği tahmin edilmemiş, belgelenmiştir. api: "openai-completions", OpenAI’ın kendi sunucusu olmayan bir ana bilgisayara karşı kullanıldığında OpenClaw compat.supportsDeveloperRole: false değerini zorunlu kılar ve OpenAI'a özgü istek şekillendirmesini atlar — service_tier yoktur, Responses veya Completions store yoktur, istem önbelleği ipuçları yoktur ve akıl yürütme uyumlu yük şekillendirmesi yoktur (özel sağlayıcılar). Gemini’ye özgü ek özellikler de geride kalır: params.cachedContent, doğrudan Gemini çalıştırmaları için belgelenmiştir; anahtar rotasyonu değişkenleri eklenti özellikleridir ve OpenClaw’ın thinkingLevel / thinkingBudget eşlemesi google sağlayıcısı için açıklanmıştır — bunun bir ağ geçidi rotasında çalışıp çalışmadığı bu sayfada doğrulanmamıştır.

Kunavo herhangi bir gömme modeli, metinden sese veya sesten metne modeli sunmaz. Bu nedenle google eklentisinin gömme ve konuşma sözleşmeleri, sohbetin nasıl yönlendirildiğinden bağımsız olarak bir Google anahtarında kalır.

Yetenekler konusunda kimin sözüne güvendiğinize dikkat edin. Google’ın güncel model sayfası artık model başına belirteç sınırlarını göstermiyor; bu nedenle başka bir yerde alıntılanan bir bağlam değeri, daha eski bir kaynağın başkasına ait kopyasıdır. Kunavo’nun kataloğu, Gemini listelerinde görme, işlev çağırma, akış ve uzun bağlam özelliklerini belirtir; gemini-2-5-flash dışındaki tüm modellerde akıl yürütmeyi de belirtir. Her iddia onu yayımlayan kişiyle sınırlıdır — araç çağrılarını önce kendi görevinizde doğrulayın.

Gerçekte seçtiğiniz modelin fiyatını hesaplayın

Google’ın Standart katmanına göre model bazında; çünkü bu karşılaştırmanın tüm aileye uygulanan biçimi bugün doğru değildir:

Kunavo ücretleri canlı katalogdan, Google ücretleri ise 21 Eylül 2026’da okunan fiyatlandırma sayfasından alınmıştır; giriş dönemi 31 Aralık 2026’da sona erer ve bundan sonra Flash karşılaştırması yeniden tersine döner.

Örnek bir tahmin; bu belirteç aritmetiğidir, ölçülmüş bir OpenClaw görevi veya fatura üst sınırı değildir. Bir haftalık asistan çalışmasında önbelleğe alınmamış 4.000.000 girdi belirteci gönderildiğini ve 150.000 çıktı belirteci alındığını, önbelleğe alma ve arama olmadığını varsayın. Kunavo ücretleriyle Gemini 3.8 Flash üzerinde bu $2,49 eder; aynı hesap Google’ın giriş dönemi Flash ücretiyle $3,56 eder ve 2027 ücretinde $7,13 tutarına yükselir. Aynı hacimleri Kunavo’da Gemini 3.6 Flash üzerinde çalıştırdığınızda $4,99 elde edersiniz — Google’ın giriş dönemi rakamının üzerinde. Model kimliğinin, sağlayıcı adının değil, karar noktası olmasının nedeni tam olarak budur.

Kunavo kataloğundaki tutar bir üst sınır değil, faturalandırma tabanıdır: üst kaynak kendi ücretini bildirdiğinde fatura, katalog maliyeti ile geçerli çarpanla çarpılmış üst kaynak maliyetinden büyük olanıdır. Önbellek ücretleri, arama temellendirmesi ve barındırma bu örneğin dışındadır; minimum yükleme ön ödemeli kredi olarak 10$’dır — bu bir finansman minimumudur; görev ücreti veya abonelik değildir. Tam işletim faturası için faturalandırma ayrıntılarına ve OpenClaw fiyatlandırmasına bakın.

Bir istekle doğrulayın, ardından her iki hesabı okuyun

openclaw config validate
openclaw gateway restart
openclaw models list --provider kunavo
openclaw infer model run --model kunavo/gemini-3-8-flash --prompt "hi" --json

openclaw models list yayımlanmış envanteri okur, openclaw models status çözümlenmiş varsayılanı ve kimlik doğrulama durumunu gösterir; hiçbiri ücretli bir görevin çalıştığını kanıtlamaz ve bilinen bir sağlayıcıda openclaw models set yalnızca uyarıyla kataloglanmamış bir modeli kaydeder. openclaw doctor --json --severity-min info ayrıca yerel kataloğun doğrulayamadığı etkin modelleri de gösterir (CLI başvurusu). Yukarıdaki tek istek, maliyet oluşturduğuna dair ilk kanıttır.

Durum koduna göre tasnif edin. OpenClaw, yerel OpenAI uyumlu bir sunucu için model_not_found imzasını belgeler ve adlandırdığı üç alan, özel sağlayıcı girdisinin ayarladığı üç alanla aynıdır: baseUrl değerinin /v1 içerdiğini doğrulayın; api, bir /v1/chat/completions arka ucu için "openai-completions" olmalıdır; models[].id ise sağlayıcı ön eki yalnızca seçim sırasında kullanılacak şekilde, sağlayıcıya özgü yalın kimlik olmalıdır (sorun giderme). Kunavo’da temel URL’nin doğru olduğunu gösteren kontrol, gerçek bir API yoluna kimlik doğrulaması olmadan yapılan istektir: GET https://api.kunavo.com/v1/models, authentication_error gövdesiyle 401 yanıtı verir; bu, URL’nin doğru, anahtarın ise eksik olduğunu gösterir. Yalın ana bilgisayar ve yalın /v1 yolu API yolu değildir ve HTML ile yanıt verir; bunlardan birine yönlendirilen istemci, bir modele ulaşmadan önce başarısız olur (21 Eylül 2026’da kontrol edilmiştir). 403, durup okunması gereken durumdur: OpenClaw bunun “CDN, WAF, bot yönetimi kuralı veya ters proxy gibi bir üst kaynak güvenlik katmanından gelebileceği” ve başarılı bir asgari curl isteğinin gerçek SDK tarzı isteklerin aynı katmandan geçeceğini garanti etmediği konusunda uyarır. Daha uzun sürümler için model bulunamadı ve Gemini API anahtarı çalışmıyor bölümlerine bakın.

Google'ın kendi rotası için Kunavo’nun Gemini API anahtarı notlarından ve Google AI Studio’dan başlayın; ağ geçidi rotası için API anahtarları bölümünde bir anahtar oluşturup Kunavo hesabı açın, ardından OpenClaw için en iyi API bölümündeki özel sağlayıcı kılavuzunu izleyin. Test ederken çalışan rotanızı kullanılabilir durumda tutun.

Hangi rota ne zaman kazanır?

Bir sağlayıcıyı yapılandırmak yerine hâlâ seçiyorsanız, Gemini API fiyatlandırması ve OpenAI uyumlu API bu kararın iki yarısını kapsar.

Sık sorulan sorular

Bu sayfa için 21 Eylül 2026’da alınanlar: OpenClaw’ın Google sağlayıcısı, resmî sağlayıcı eklentileri, Gemini araması, web araması, özel sağlayıcı (hem kavramlar hem ağ geçidi başvurusu), hızlı kurallar, CLI modelleri ve sorun giderme belgeleri; Google’ın Gemini API fiyatlandırma sayfası (son güncelleme 16 Eylül 2026), modeller sayfası, Google Arama temellendirme sayfası ve 19 Mayıs 2026 tarihli geliştirici blogu; openclaw için npm kayıt defteri girdisi; ve Kunavo’nun kendi kataloğu. 1 Ekim 2026’da özel sağlayıcı api değerleri ağ geçidi başvurusu, Google sağlayıcısı sayfası, OpenClaw yapılandırma şeması ve v2026.9.7 kaynak kodundaki Interactions aktarımıyla yeniden kontrol edildi. Bu sayfa için yapılan tek canlı istek, yukarıda açıklanan 401 durumunu kaydetmek amacıyla Kunavo’nun /v1/models adresine gönderilen kimlik doğrulamasız bir GET isteğiydi. Buradaki hiçbir şey OpenClaw kurulumu, Kunavo uç noktası veya Google üzerinde çalışma zamanında test edilmedi; her dolar rakamı yayımlanmış ücretler üzerinden yapılan örnek bir aritmetiktir.