Providers

Google (Gemini)

Google Plugin, Google AI Studio üzerinden Gemini modellerine erişimin yanı sıra görüntü oluşturma, medya anlama (görüntü/ses/video), metinden konuşmaya dönüştürme ve Gemini Grounding aracılığıyla web araması sağlar.

Sağlayıcı: google
Kimlik doğrulama: GEMINI_API_KEY veya GOOGLE_API_KEY
API: Google Gemini API
Çalışma zamanı seçeneği: agentRuntime.id: "google-gemini-cli", model referanslarını google/* biçiminde kanonik tutarken Gemini CLI OAuth'u yeniden kullanır.

Başlarken

Tercih ettiğiniz kimlik doğrulama yöntemini seçin ve kurulum adımlarını izleyin.

API anahtarı

En uygun kullanım: Google AI Studio üzerinden standart Gemini API erişimi.

İlk kurulumu çalıştırın

bash

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

Ya da anahtarı doğrudan geçirin:

bash

openclaw onboard --non-interactive \  --mode local \  --auth-choice gemini-api-key \  --gemini-api-key "$GEMINI_API_KEY"

Varsayılan bir model ayarlayın

json5

{  agents: {    defaults: {      model: { primary: "google/gemini-3.1-pro-preview" },    },  },}

Modelin kullanılabilir olduğunu doğrulayın

bash

openclaw models list --provider google

Gemini CLI (OAuth)

En uygun kullanım: Ayrı bir API anahtarı yerine PKCE OAuth aracılığıyla mevcut bir Gemini CLI oturumunu yeniden kullanma.

Gemini CLI'ı yükleyin

Yerel gemini komutu PATH üzerinde kullanılabilir olmalıdır.

bash

# Homebrewbrew install gemini-cli # veya npmnpm install -g @google/gemini-cli

OpenClaw, yaygın Windows/npm düzenleri dâhil olmak üzere hem Homebrew yüklemelerini hem de genel npm yüklemelerini destekler.

OAuth aracılığıyla oturum açın

bash

openclaw models auth login --provider google-gemini-cli --set-default

Modelin kullanılabilir olduğunu doğrulayın

bash

openclaw models list --provider google

Varsayılan model: google/gemini-3.1-pro-preview
Çalışma zamanı: google-gemini-cli
Diğer ad: gemini-cli

Gemini 3.1 Pro'nun Gemini API model kimliği gemini-3.1-pro-preview değeridir. OpenClaw, kolaylık sağlayan bir diğer ad olarak daha kısa google/gemini-3.1-pro biçimini kabul eder ve sağlayıcı çağrılarından önce bunu normalleştirir.

Ortam değişkenleri:

OPENCLAW_GEMINI_OAUTH_CLIENT_ID / GEMINI_CLI_OAUTH_CLIENT_ID
OPENCLAW_GEMINI_OAUTH_CLIENT_SECRET / GEMINI_CLI_OAUTH_CLIENT_SECRET

google-gemini-cli/* model referansları eski uyumluluk diğer adlarıdır. Yeni yapılandırmalar, yerel Gemini CLI çalıştırması istediklerinde google-gemini-cli çalışma zamanı ile birlikte google/* model referanslarını kullanmalıdır.

Yetenekler

Yetenek	Destekleniyor
Sohbet tamamlamaları	Evet
Görüntü oluşturma	Evet
Müzik oluşturma	Evet
Metinden konuşmaya	Evet
Gerçek zamanlı ses	Evet (Google Live API)
Görüntü anlama	Evet
Ses transkripsiyonu	Evet
Video anlama	Evet
Web araması (Grounding)	Evet
Düşünme/akıl yürütme	Evet (Gemini 2.5+ / Gemini 3+)
Gemma 4 modelleri	Evet

Web araması

Paketle gelen gemini web araması sağlayıcısı, Gemini Google Search Grounding'i kullanır. plugins.entries.google.config.webSearch altında özel bir arama anahtarı yapılandırın veya GEMINI_API_KEY sonrasında models.providers.google.apiKey değerini yeniden kullanmasına izin verin:

json5

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // GEMINI_API_KEY veya models.providers.google.apiKey ayarlanmışsa isteğe bağlıdır            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // models.providers.google.baseUrl değerine geri döner            model: "gemini-2.5-flash",          },        },      },    },  },}

Kimlik bilgisi önceliği sırasıyla özel webSearch.apiKey, GEMINI_API_KEY ve models.providers.google.apiKey şeklindedir. webSearch.baseUrl isteğe bağlıdır ve operatör proxy'leri veya uyumlu Gemini API uç noktaları için bulunur; belirtilmediğinde Gemini web araması models.providers.google.baseUrl değerini yeniden kullanır. Sağlayıcıya özgü araç davranışı için Gemini araması bölümüne bakın.

Tip

Gemini 3 modelleri thinkingBudget yerine thinkingLevel kullanır. OpenClaw, varsayılan/düşük gecikmeli çalıştırmaların devre dışı bırakılmış thinkingBudget değerleri göndermemesi için Gemini 3, Gemini 3.1 ve gemini-*-latest diğer adlarının akıl yürütme denetimlerini thinkingLevel değerine eşler.

/think adaptive, sabit bir OpenClaw düzeyi seçmek yerine Google'ın dinamik düşünme semantiğini korur. Google'ın düzeyi seçebilmesi için Gemini 3 ve Gemini 3.1 sabit bir thinkingLevel belirtmez; Gemini 2.5 ise Google'ın dinamik işaretçisi olan thinkingBudget: -1 değerini gönderir.

Gemma 4 modelleri (örneğin gemma-4-26b-a4b-it) düşünme modunu destekler. OpenClaw, Gemma 4 için thinkingBudget değerini desteklenen bir Google thinkingLevel değerine dönüştürür. Düşünmeyi off olarak ayarlamak, MINIMAL değerine eşlemek yerine düşünmeyi devre dışı bırakılmış hâlde korur.

Gemini 2.5 Pro yalnızca düşünme modunda çalışır ve açıkça belirtilen thinkingBudget: 0 değerini reddeder; OpenClaw bu değeri göndermek yerine Gemini 2.5 Pro isteklerinden kaldırır.

Görüntü oluşturma

Paketle gelen google görüntü oluşturma sağlayıcısının varsayılanı google/gemini-3.1-flash-image-preview modelidir.

google/gemini-3-pro-image-preview modelini de destekler
Oluşturma: istek başına en fazla 4 görüntü
Düzenleme modu: etkin, en fazla 5 girdi görüntüsü
Geometri denetimleri: size, aspectRatio ve resolution

Google'ı varsayılan görüntü sağlayıcısı olarak kullanmak için:

json5

{  agents: {    defaults: {      imageGenerationModel: {        primary: "google/gemini-3.1-flash-image-preview",      },    },  },}

Video oluşturma

Paketle gelen google Plugin'i ayrıca paylaşılan video_generate aracı aracılığıyla video oluşturmayı kaydeder.

Varsayılan video modeli: google/veo-3.1-fast-generate-preview
Modlar: metinden videoya, görüntüden videoya ve tek video referanslı akışlar
aspectRatio (16:9, 9:16) ve resolution (720P, 1080P) desteklenir; Veo şu anda ses çıktısını desteklemez
Desteklenen süreler: 4, 6 veya 8 saniye (diğer değerler izin verilen en yakın değere yuvarlanır)

Google'ı varsayılan video sağlayıcısı olarak kullanmak için:

json5

{  agents: {    defaults: {      videoGenerationModel: {        primary: "google/veo-3.1-fast-generate-preview",      },    },  },}

Müzik oluşturma

Paketle gelen google Plugin'i ayrıca paylaşılan music_generate aracı aracılığıyla müzik oluşturmayı kaydeder.

Varsayılan müzik modeli: google/lyria-3-clip-preview
google/lyria-3-pro-preview modelini de destekler
İstem denetimleri: lyrics ve instrumental
Çıktı biçimi: varsayılan olarak mp3; google/lyria-3-pro-preview modelinde ayrıca wav
Referans girdileri: en fazla 10 görüntü
Oturum destekli çalıştırmalar, action: "status" dâhil olmak üzere paylaşılan görev/durum akışı üzerinden ayrılır

Google'ı varsayılan müzik sağlayıcısı olarak kullanmak için:

json5

{  agents: {    defaults: {      musicGenerationModel: {        primary: "google/lyria-3-clip-preview",      },    },  },}

Metinden konuşmaya

Paketle gelen google konuşma sağlayıcısı, gemini-3.1-flash-tts-preview ile Gemini API TTS yolunu kullanır.

Varsayılan ses: Kore
Kimlik doğrulama: messages.tts.providers.google.apiKey, models.providers.google.apiKey, GEMINI_API_KEY veya GOOGLE_API_KEY
Çıktı: normal TTS ekleri için WAV, sesli not hedefleri için Opus, konuşma/telefon için PCM
Sesli not çıktısı: Google PCM, WAV olarak sarmalanır ve ffmpeg ile 48 kHz Opus biçimine dönüştürülür

Google'ın toplu Gemini TTS yolu, oluşturulan sesi tamamlanmış generateContent yanıtında döndürür. En düşük gecikmeli sesli konuşmalar için toplu TTS yerine Gemini Live API destekli Google gerçek zamanlı ses sağlayıcısını kullanın.

Google'ı varsayılan TTS sağlayıcısı olarak kullanmak için:

json5

{  messages: {    tts: {      auto: "always",      provider: "google",      providers: {        google: {          model: "gemini-3.1-flash-tts-preview",          speakerVoice: "Kore",          audioProfile: "Sakin bir tonla profesyonel biçimde konuş.",        },      },    },  },}

Gemini API TTS, stil denetimi için doğal dil istemlerini kullanır. Konuşulan metnin önüne yeniden kullanılabilir bir stil istemi eklemek için audioProfile değerini ayarlayın. İstem metniniz adı belirtilmiş bir konuşmacıya atıfta bulunuyorsa speakerName değerini ayarlayın.

Gemini API TTS ayrıca metinde [whispers] veya [laughs] gibi ifade belirten köşeli parantezli ses etiketlerini kabul eder. Etiketleri TTS'ye gönderirken görünür sohbet yanıtının dışında tutmak için bunları bir [[tts:text]]...[[/tts:text]] bloğunun içine yerleştirin:

text

İşte temiz yanıt metni. [[tts:text]][whispers] İşte seslendirilen sürüm.[[/tts:text]]

Gerçek zamanlı ses

Paketle gelen google Plugin'i, Voice Call ve Google Meet gibi arka uç ses köprüleri için Gemini Live API destekli bir gerçek zamanlı ses sağlayıcısı kaydeder.

Ayar	Yapılandırma yolu	Varsayılan
Model	`plugins.entries.voice-call.config.realtime.providers.google.model`	`gemini-3.1-flash-live-preview`
Ses	`...google.voice`	`Kore`
Sıcaklık	`...google.temperature`	(ayarlanmamış)
VAD başlangıç hassasiyeti	`...google.startSensitivity`	(ayarlanmamış)
VAD bitiş hassasiyeti	`...google.endSensitivity`	(ayarlanmamış)
Sessizlik süresi	`...google.silenceDurationMs`	(ayarlanmamış)
Etkinlik işleme	`...google.activityHandling`	Google varsayılanı, `start-of-activity-interrupts`
Konuşma sırası kapsamı	`...google.turnCoverage`	Google varsayılanı, `audio-activity-and-all-video`
Otomatik VAD'yi devre dışı bırak	`...google.automaticActivityDetectionDisabled`	`false`
Oturumu sürdürme	`...google.sessionResumption`	`true`
Bağlam sıkıştırma	`...google.contextWindowCompression`	`true`
API anahtarı	`...google.apiKey`	Bulunamazsa `models.providers.google.apiKey`, `GEMINI_API_KEY` veya `GOOGLE_API_KEY` kullanılır

Gerçek zamanlı Sesli Arama yapılandırması örneği:

json5

{  plugins: {    entries: {      "voice-call": {        enabled: true,        config: {          realtime: {            enabled: true,            provider: "google",            providers: {              google: {                model: "gemini-3.1-flash-live-preview",                speakerVoice: "Kore",                activityHandling: "start-of-activity-interrupts",                turnCoverage: "audio-activity-and-all-video",              },            },          },        },      },    },  },}

Bakım sorumlusu tarafından canlı doğrulama için OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts komutunu çalıştırın. Smoke testi ayrıca OpenAI arka uç/WebRTC yollarını da kapsar; Google aşaması, Control UI Talk tarafından kullanılanla aynı kısıtlanmış Live API token biçimini oluşturur, tarayıcı WebSocket uç noktasını açar, ilk kurulum yükünü gönderir ve setupComplete olayını bekler.

Gelişmiş yapılandırma

Doğrudan Gemini önbelleğini yeniden kullanma

Doğrudan Gemini API çalıştırmalarında (api: "google-generative-ai"), OpenClaw yapılandırılmış bir cachedContent tanıtıcısını Gemini isteklerine iletir.

Model başına veya genel parametreleri cachedContent ya da eski cached_content ile yapılandırın.
Daha özel bir kapsamdaki parametreler (genel kapsam yerine model düzeyi) her zaman önceliklidir. Aynı kapsamda her iki anahtar da ayarlanmışsa cached_content önceliklidir. Beklenmedik sonuçları önlemek için her kapsamda yalnızca bir anahtar kullanın.
Örnek değer: cachedContents/prebuilt-context
Gemini önbellek isabeti kullanımı, üst kaynak cachedContentTokenCount değerinden OpenClaw cacheRead alanına normalleştirilir.

json5

{  agents: {    defaults: {      models: {        "google/gemini-2.5-pro": {          params: {            cachedContent: "cachedContents/prebuilt-context",          },        },      },    },  },}

Gemini CLI kullanım notları

google-gemini-cli OAuth sağlayıcısı kullanılırken OpenClaw, varsayılan olarak Gemini CLI stream-json çıktısını kullanır ve kullanımı son stats yükünden normalleştirir. Eski --output-format json geçersiz kılmaları JSON ayrıştırıcısını kullanmaya devam eder.

Akışla iletilen yanıt metni, asistanın message olaylarından gelir.
Eski JSON çıktısında yanıt metni, CLI JSON response alanından gelir.
CLI, usage alanını boş bıraktığında kullanım için stats değerine geri dönülür.
stats.cached, OpenClaw cacheRead alanına normalleştirilir.
stats.input eksikse OpenClaw, giriş token'larını stats.input_tokens - stats.cached işleminden türetir.

Ortam ve daemon kurulumu

Gateway bir daemon (launchd/systemd) olarak çalışıyorsa GEMINI_API_KEY değerinin bu işlem tarafından erişilebilir olduğundan emin olun (örneğin ~/.openclaw/.env içinde veya env.shellEnv aracılığıyla).

İlgili içerikler

Model seçimi

Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.

Görsel oluşturma

Paylaşılan görsel aracı parametreleri ve sağlayıcı seçimi.

Video oluşturma

Paylaşılan video aracı parametreleri ve sağlayıcı seçimi.

Müzik oluşturma

Paylaşılan müzik aracı parametreleri ve sağlayıcı seçimi.

Was this useful?

Google (Gemini)

Başlarken

API anahtarı

İlk kurulumu çalıştırın

Varsayılan bir model ayarlayın

Modelin kullanılabilir olduğunu doğrulayın

Gemini CLI (OAuth)

Gemini CLI'ı yükleyin

OAuth aracılığıyla oturum açın

Modelin kullanılabilir olduğunu doğrulayın

Yetenekler

Web araması

Görüntü oluşturma

Video oluşturma

Müzik oluşturma

Metinden konuşmaya

Gerçek zamanlı ses

Gelişmiş yapılandırma

İlgili içerikler

On this page

Molty