Google (Gemini)

Google plugini, 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 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 standart tutarken Gemini CLI OAuth'u yeniden kullanır.

Başlarken

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

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

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

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

openclaw models list --provider google

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

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

openclaw models list --provider google

Yetenekler

Web araması

Paketle birlikte gelen gemini web araması sağlayıcısı, Gemini Google Search grounding özelliğini 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:

{  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, ardından GEMINI_API_KEY ve son olarak models.providers.google.apiKey biçimindedir. 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.

Görüntü oluşturma

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

• Ayrıca desteklenir: google/gemini-3-pro-image
• 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:

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

Video oluşturma

Paketle birlikte gelen google plugin ayrıca paylaşılan video_generate aracı üzerinden 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; ses çıkışı şu anda Veo tarafından desteklenmemektedir
• 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:

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

Müzik oluşturma

Paketle birlikte gelen google plugin ayrıca paylaşılan music_generate aracı üzerinden müzik oluşturmayı kaydeder.

• Varsayılan müzik modeli: google/lyria-3-clip-preview
• Ayrıca desteklenir: google/lyria-3-pro-preview
• İstem denetimleri: lyrics ve instrumental
• Çıkış biçimi: varsayılan olarak mp3, ayrıca google/lyria-3-pro-preview üzerinde 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:

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

Metinden konuşmaya

Paketle birlikte 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: 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/telefon için PCM
• Sesli not çıkışı: Google PCM, WAV olarak sarmalanır ve ffmpeg ile 48 kHz Opus'a 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 görüşmeler 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:

{  tts: {    auto: "always",    provider: "google",    providers: {      google: {        model: "gemini-3.1-flash-tts-preview",        speakerVoice: "Kore",        audioProfile: "Sakin bir tonla profesyonelce konuşun.",      },    },  },}

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 değerini ayarlayın. İstem metni adlandırılmış bir konuşmacıya atıfta bulunuyorsa speakerName değerini ayarlayın.

Gemini API TTS ayrıca metin içinde [whispers] veya [laughs] gibi etkileyici 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:

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

Gerçek zamanlı ses

Paketle birlikte gelen google plugin, 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.

Örnek gerçek zamanlı Sesli Arama yapılandırması:

{  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 canlı doğrulaması için OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts komutunu çalıştırın. Hızlı kontrol ayrıca OpenAI arka uç/WebRTC yollarını da kapsar; Google ayağı, Control UI Talk tarafından kullanılanla aynı kısıtlı Live API token biçimini oluşturur, tarayıcı WebSocket uç noktasını açar, ilk kurulum yükünü bir JPEG karesiyle birlikte gönderir ve bir metin yanıtını ve describe_view işlev gidiş dönüşünü doğrular.

Gelişmiş yapılandırma

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

İlgili içerikler