--- 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-05-11T20:35:46Z" model: gpt-5.5 provider: openai source_hash: 740ff99392d352e8c0f479af6002c52195b0c40e3ef688289d27dec583174847 source_path: providers/google.md workflow: 16 --- Google Plugin'i, Google AI Studio üzerinden Gemini modellerine erişimin yanı sıra görüntü oluşturma, medya anlama (görüntü/ses/video), metinden sese 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: sağlayıcı/model `agentRuntime.id: "google-gemini-cli"` model başvurularını `google/*` olarak 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 ``` `GEMINI_API_KEY` ve `GOOGLE_API_KEY` ortam değişkenlerinin ikisi de kabul edilir. Hangisini zaten yapılandırdıysanız onu 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ı resmi olmayan bir entegrasyondur. Bazı kullanıcılar OAuth'u bu şekilde kullanırken hesap kısıtlamaları bildirmiştir. Riski size ait olmak üzere kullanın. Yerel `gemini` komutu `PATH` üzerinde kullanılabilir olmalıdır. ```bash # Homebrew brew install gemini-cli # or npm npm install -g @google/gemini-cli ``` OpenClaw, yaygın Windows/npm düzenleri dahil olmak üzere hem Homebrew kurulumlarını hem de global npm kurulumlarını 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` - Takma ad: `gemini-cli` Gemini 3.1 Pro'nun Gemini API model kimliği `gemini-3.1-pro-preview` şeklindedir. OpenClaw, kolaylık takma adı olarak daha kısa `google/gemini-3.1-pro` değerini kabul eder ve sağlayıcı çağrılarından önce bunu normalleştirir. **Ortam değişkenleri:** - `OPENCLAW_GEMINI_OAUTH_CLIENT_ID` - `OPENCLAW_GEMINI_OAUTH_CLIENT_SECRET` (Ya da `GEMINI_CLI_*` varyantları.) Gemini CLI OAuth istekleri oturum açtıktan sonra başarısız olursa gateway ana makinesinde `GOOGLE_CLOUD_PROJECT` veya `GOOGLE_CLOUD_PROJECT_ID` ayarlayın ve yeniden deneyin. Oturum açma, tarayıcı akışı başlamadan önce başarısız olursa yerel `gemini` komutunun kurulu olduğundan ve `PATH` üzerinde bulunduğundan emin olun. `google-gemini-cli/*` model başvuruları eski uyumluluk takma adlarıdır. Yeni yapılandırmalar, yerel Gemini CLI yürütmesi istediklerinde `google/*` model başvurularını ve `google-gemini-cli` çalışma zamanını kullanmalıdır. ## Yetenekler | Yetenek | Destekleniyor | | ---------------------- | ----------------------------- | | Sohbet tamamlamaları | Evet | | Görüntü oluşturma | Evet | | Müzik oluşturma | Evet | | Metinden sese | 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ı Paketlenen `gemini` web araması sağlayıcısı, Gemini Google Search grounding kullanır. `plugins.entries.google.config.webSearch` altında özel bir arama anahtarı yapılandırın ya da `GEMINI_API_KEY` sonrasında `models.providers.google.apiKey` değerini yeniden kullanmasına izin verin: ```json5 { plugins: { entries: { google: { config: { webSearch: { apiKey: "AIza...", // optional if GEMINI_API_KEY or models.providers.google.apiKey is set baseUrl: "https://generativelanguage.googleapis.com/v1beta", // falls back to models.providers.google.baseUrl model: "gemini-2.5-flash", }, }, }, }, }, } ``` Kimlik bilgisi önceliği önce özel `webSearch.apiKey`, sonra `GEMINI_API_KEY`, ardından `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; atlandığında 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, Gemini 3, Gemini 3.1 ve `gemini-*-latest` takma ad akıl yürütme denetimlerini `thinkingLevel` değerine eşler; böylece varsayılan/düşük gecikmeli çalıştırmalar devre dışı `thinkingBudget` değerleri göndermez. `/think adaptive`, sabit bir OpenClaw seviyesi seçmek yerine Google'ın dinamik düşünme semantiğini korur. Gemini 3 ve Gemini 3.1, Google'ın seviyeyi seçebilmesi için sabit bir `thinkingLevel` göndermez; 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 yeniden yazar. Düşünmeyi `off` olarak ayarlamak, `MINIMAL` değerine eşlemek yerine düşünmenin devre dışı kalmasını korur. ## Görüntü oluşturma Paketlenen `google` görüntü oluşturma sağlayıcısı varsayılan olarak `google/gemini-3.1-flash-image-preview` kullanır. - `google/gemini-3-pro-image-preview` da desteklenir - Oluşturma: istek başına en fazla 4 görüntü - Düzenleme modu: etkin, en fazla 5 giriş 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 Paketlenen `google` Plugin'i, paylaşılan `video_generate` aracı üzerinden video oluşturmayı da kaydeder. - Varsayılan video modeli: `google/veo-3.1-fast-generate-preview` - Modlar: metinden videoya, görüntüden videoya ve tek video referans akışları - `aspectRatio` (`16:9`, `9:16`) ve `resolution` (`720P`, `1080P`) destekler; ses çıktısı bugün Veo tarafından desteklenmez - Desteklenen süreler: **4, 6 veya 8 saniye** (diğer değerler en yakın izin verilen 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 Paketlenen `google` Plugin'i, paylaşılan `music_generate` aracı üzerinden müzik oluşturmayı da kaydeder. - Varsayılan müzik modeli: `google/lyria-3-clip-preview` - `google/lyria-3-pro-preview` da desteklenir - İstem denetimleri: `lyrics` ve `instrumental` - Çıkış biçimi: varsayılan olarak `mp3`, ayrıca `google/lyria-3-pro-preview` üzerinde `wav` - Referans girişleri: en fazla 10 görüntü - Oturum destekli çalıştırmalar, `action: "status"` dahil 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 sese Paketlenen `google` konuşma sağlayıcısı, Gemini API TTS yolunu `gemini-3.1-flash-tts-preview` ile 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` - Çıkış: normal TTS ekleri için WAV, sesli not hedefleri için Opus, Talk/telephony için PCM - Sesli not çıktısı: Google PCM, WAV olarak sarılır ve `ffmpeg` ile 48 kHz Opus'a dönüştürülür Google'ın toplu Gemini TTS yolu, tamamlanmış `generateContent` yanıtında oluşturulan sesi döndürür. En düşük gecikmeli konuşmalı görüşmeler için toplu TTS yerine Gemini Live API tarafından desteklenen 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", voiceName: "Kore", audioProfile: "Speak professionally with a calm tone.", }, }, }, }, } ``` Gemini API TTS, stil denetimi için doğal dil istemleri kullanır. Konuşulan metinden önce yeniden kullanılabilir bir stil istemi eklemek için `audioProfile` ayarlayın. İstem metniniz adlandırılmış bir konuşmacıya atıfta bulunuyorsa `speakerName` ayarlayın. Gemini API TTS ayrıca metinde `[whispers]` veya `[laughs]` gibi ifadeli köşeli parantez ses etiketlerini kabul eder. Etiketleri görünür sohbet yanıtının dışında tutarken TTS'ye göndermek için bunları bir `[[tts:text]]...[[/tts:text]]` bloğunun içine koyun: ```text Here is the clean reply text. [[tts:text]][whispers] Here is the spoken version.[[/tts:text]] ``` Gemini API ile sınırlandırılmış 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 Paketlenen `google` Plugin'i, Voice Call ve Google Meet gibi arka uç ses köprüleri için Gemini Live API tarafından desteklenen 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-2.5-flash-native-audio-preview-12-2025` | | 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` | | Tur kapsamı | `...google.turnCoverage` | Google varsayılanı, `only-activity` | | Otomatik VAD'yi devre dışı bırak | `...google.automaticActivityDetectionDisabled` | `false` | | Oturum sürdürme | `...google.sessionResumption` | `true` | | Bağlam sıkıştırma | `...google.contextWindowCompression` | `true` | | API anahtarı | `...google.apiKey` | `models.providers.google.apiKey`, `GEMINI_API_KEY` veya `GOOGLE_API_KEY` değerine geri döner | Örnek Voice Call gerçek zamanlı yapılandırması: ```json5 { plugins: { entries: { "voice-call": { enabled: true, config: { realtime: { enabled: true, provider: "google", providers: { google: { model: "gemini-2.5-flash-native-audio-preview-12-2025", voice: "Kore", activityHandling: "start-of-activity-interrupts", turnCoverage: "only-activity", }, }, }, }, }, }, }, } ``` Google Live API, WebSocket üzerinden çift yönlü ses ve işlev çağırma kullanır. OpenClaw, telefon/Meet köprüsü 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 yoksa `temperature` değerini ayarlanmamış bırakın; OpenClaw pozitif olmayan değerleri atlar çünkü Google Live, `temperature: 0` için ses olmadan transkript döndürebilir. Gemini API transkripsiyonu `languageCodes` olmadan etkinleştirilir; mevcut Google SDK, bu API yolunda dil kodu ipuçlarını reddeder. Control UI Talk, kısıtlı tek kullanımlık belirteçlerle Google Live tarayıcı oturumlarını destekler. Yalnızca arka uç gerçek zamanlı ses sağlayıcıları, sağlayıcı kimlik bilgilerini Gateway'de tutan genel Gateway aktarma taşıması üzerinden de çalışabilir. Bakımcı canlı doğrulaması için `OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts` çalıştırın. Smoke, OpenAI arka uç/WebRTC yollarını da kapsar; Google ayağı, Control UI Talk tarafından kullanılan aynı kısıtlı Live API belirteci şeklini üretir, tarayıcı WebSocket uç noktasını açar, ilk kurulum yükünü gönderir ve `setupComplete` için bekler. ## Gelişmiş yapılandırma Doğrudan Gemini API çalıştırmaları (`api: "google-generative-ai"`) için OpenClaw, yapılandırılmış bir `cachedContent` tanıtıcısını Gemini isteklerine geçirir. - Model başına veya genel parametreleri `cachedContent` ya da eski `cached_content` ile yapılandırın - İkisi de varsa `cachedContent` kazanır - Örnek değer: `cachedContents/prebuilt-context` - Gemini önbellek isabeti kullanımı, yukarı akış `cachedContentTokenCount` değerinden OpenClaw `cacheRead` içine normalize edilir ```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, CLI JSON çıktısını aşağıdaki şekilde normalize eder: - Yanıt metni, CLI JSON `response` alanından gelir. - CLI `usage` değerini boş bıraktığında kullanım `stats` değerine geri döner. - `stats.cached`, OpenClaw `cacheRead` içine normalize edilir. - `stats.input` eksikse OpenClaw, giriş belirteçlerini `stats.input_tokens - stats.cached` değerinden türetir. Gateway bir daemon (launchd/systemd) olarak çalışıyorsa `GEMINI_API_KEY` değerinin bu süreç tarafından kullanılabildiğinden emin olun (örneğin, `~/.openclaw/.env` içinde veya `env.shellEnv` üzerinden). ## İlgili Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme. Paylaşılan görüntü 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.