--- read_when: - OpenClaw ile Google Gemini modellerini kullanmak istiyorsunuz - API anahtarına veya OAuth kimlik doğrulama akışına ihtiyacınız var summary: Google Gemini kurulumu (API anahtarı + OAuth, görüntü oluşturma, medya anlama, TTS, web araması) title: Google (Gemini) x-i18n: generated_at: "2026-07-12T12:42:37Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 423f9b048a705815e886690fa13f5b02f7e67707195b7b461f6b4765528a4756 source_path: providers/google.md workflow: 16 --- 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. **En uygun kullanım:** Google AI Studio üzerinden standart Gemini API erişimi. ```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" ``` ```json5 { agents: { defaults: { model: { primary: "google/gemini-3.1-pro-preview" }, }, }, } ``` ```bash openclaw models list --provider google ``` Hem `GEMINI_API_KEY` hem de `GOOGLE_API_KEY` kabul edilir. Önceden yapılandırmış olduğunuz anahtarı kullanın. **En uygun kullanım:** Ayrı bir API anahtarı yerine PKCE OAuth aracılığıyla mevcut bir Gemini CLI oturumunu yeniden kullanma. `google-gemini-cli` sağlayıcısı resmî olmayan bir entegrasyondur. Bazı kullanıcılar OAuth'u bu şekilde kullanırken hesap kısıtlamalarıyla karşılaştıklarını bildirmektedir. Kullanım riski size aittir. Yerel `gemini` komutu `PATH` üzerinde kullanılabilir olmalıdır. ```bash # Homebrew brew install gemini-cli # veya npm npm 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. ```bash openclaw models auth login --provider google-gemini-cli --set-default ``` ```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` Gemini CLI OAuth istekleri oturum açtıktan sonra başarısız olursa Gateway ana bilgisayarında `GOOGLE_CLOUD_PROJECT` veya `GOOGLE_CLOUD_PROJECT_ID` ayarlayın ve yeniden deneyin. Tarayıcı akışı başlamadan önce oturum açma başarısız olursa yerel `gemini` komutunun yüklü ve `PATH` üzerinde bulunduğundan emin olun. `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. `google/gemini-3-pro-preview`, 2026-03-09 tarihinde kullanımdan kaldırıldı; bunun yerine `google/gemini-3.1-pro-preview` kullanın. Gemini API anahtarı kurulumunu yeniden çalıştırmak (`openclaw onboard --auth-choice gemini-api-key` veya `openclaw models auth login --provider google`), yapılandırılmış eski bir varsayılanı güncel modelle değiştirir. ## 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ı](/tr/tools/gemini-search) bölümüne bakın. 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", }, }, }, } ``` Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için [Görüntü Oluşturma](/tr/tools/image-generation) bölümüne bakın. ## 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", }, }, }, } ``` Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için [Video Oluşturma](/tr/tools/video-generation) bölümüne bakın. ## 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", }, }, }, } ``` Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için [Müzik Oluşturma](/tr/tools/music-generation) bölümüne bakın. ## 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]] ``` Gemini API ile kısıtlanmış bir Google Cloud Console API anahtarı bu sağlayıcı için geçerlidir. Bu, ayrı Cloud Text-to-Speech API yolu değildir. ## 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", }, }, }, }, }, }, }, } ``` Google Live API, WebSocket üzerinden çift yönlü ses ve işlev çağrısı kullanır. OpenClaw, telefon/Meet köprü sesini Gemini'nin PCM Live API akışına uyarlar ve araç çağrılarını paylaşılan gerçek zamanlı ses sözleşmesinde tutar. Örnekleme değişikliklerine ihtiyacınız olmadığı sürece `temperature` değerini ayarlamayın; Google Live, `temperature: 0` için ses olmadan transkript döndürebildiğinden OpenClaw pozitif olmayan değerleri göndermez. Gemini API transkripsiyonu `languageCodes` olmadan etkinleştirilir; mevcut Google SDK, bu API yolundaki dil kodu ipuçlarını reddeder. Gemini 3.1 Live, gerçek zamanlı giriş üzerinden konuşma metnini kabul eder ve sıralı işlev çağrısı kullanır. OpenClaw bu model için eski `NON_BLOCKING`, işlev yanıtı zamanlama ve duygusal diyalog alanlarını göndermez. `thinkingLevel` kullanmayı tercih edin; yapılandırılmış pozitif `thinkingBudget` değerleri desteklenen en yakın düzeye eşlenirken `-1`, Google'ın varsayılanını korur. [Gemini Live yetenek karşılaştırmasına](https://ai.google.dev/gemini-api/docs/live-api/capabilities) bakın. Control UI Talk, kısıtlanmış tek kullanımlık token'larla Google Live tarayıcı oturumlarını destekler. Yalnızca arka uçta çalışan gerçek zamanlı ses sağlayıcıları, sağlayıcı kimlik bilgilerini Gateway üzerinde tutan genel Gateway aktarma taşıması üzerinden de çalışabilir. 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 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", }, }, }, }, }, } ``` `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. 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 Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme. Paylaşılan görsel aracı parametreleri ve sağlayıcı seçimi. Paylaşılan video aracı parametreleri ve sağlayıcı seçimi. Paylaşılan müzik aracı parametreleri ve sağlayıcı seçimi.