Google (Gemini)

De Google-Plugin biedt toegang tot Gemini-modellen via Google AI Studio, plus afbeeldingsgeneratie, mediabegrip (afbeelding/audio/video), tekst-naar-spraak en webzoekopdrachten via Gemini Grounding.

• Aanbieder: google
• Authenticatie: GEMINI_API_KEY of GOOGLE_API_KEY
• API: Google Gemini API
• Runtimeoptie: provider/model agentRuntime.id: "google-gemini-cli" hergebruikt Gemini CLI OAuth terwijl modelverwijzingen canoniek blijven als google/*.

Aan de slag

Kies je gewenste authenticatiemethode en volg de installatiestappen.

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 # or npmnpm install -g @google/gemini-cli

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

openclaw models list --provider google

Mogelijkheden

Webzoekopdracht

De meegeleverde gemini-provider voor webzoekopdrachten gebruikt Gemini Google Search-grounding. Configureer een specifieke zoeksleutel onder plugins.entries.google.config.webSearch, of laat deze models.providers.google.apiKey hergebruiken na GEMINI_API_KEY:

{  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",          },        },      },    },  },}

De volgorde van credentialvoorrang is de specifieke webSearch.apiKey, daarna GEMINI_API_KEY, daarna models.providers.google.apiKey. webSearch.baseUrl is optioneel en bestaat voor operatorproxies of compatibele Gemini API-eindpunten; wanneer dit wordt weggelaten, hergebruikt Gemini-webzoekopdracht models.providers.google.baseUrl. Zie Gemini-zoekopdracht voor het providerspecifieke toolgedrag.

Afbeeldingsgeneratie

De meegeleverde google-provider voor afbeeldingsgeneratie gebruikt standaard google/gemini-3.1-flash-image-preview.

• Ondersteunt ook google/gemini-3-pro-image-preview
• Genereren: maximaal 4 afbeeldingen per aanvraag
• Bewerkingsmodus: ingeschakeld, maximaal 5 invoerafbeeldingen
• Geometrie-instellingen: size, aspectRatio en resolution

Google als standaardprovider voor afbeeldingen gebruiken:

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

Videogeneratie

De meegeleverde google-Plugin registreert ook videogeneratie via de gedeelde tool video_generate.

• Standaardvideomodel: google/veo-3.1-fast-generate-preview
• Modi: tekst-naar-video, afbeelding-naar-video en flows met één videoreferentie
• Ondersteunt aspectRatio (16:9, 9:16) en resolution (720P, 1080P); audio-uitvoer wordt vandaag niet ondersteund door Veo
• Ondersteunde duurwaarden: 4, 6 of 8 seconden (andere waarden worden afgerond naar de dichtstbijzijnde toegestane waarde)

Google als standaardprovider voor video gebruiken:

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

Muziekgeneratie

De meegeleverde google-Plugin registreert ook muziekgeneratie via de gedeelde tool music_generate.

• Standaardmuziekmodel: google/lyria-3-clip-preview
• Ondersteunt ook google/lyria-3-pro-preview
• Promptinstellingen: lyrics en instrumental
• Uitvoerformaat: standaard mp3, plus wav op google/lyria-3-pro-preview
• Referentie-invoer: maximaal 10 afbeeldingen
• Runs met sessieondersteuning worden losgekoppeld via de gedeelde taak-/statusflow, inclusief action: "status"

Google als standaardprovider voor muziek gebruiken:

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

Tekst-naar-spraak

De meegeleverde google-spraakprovider gebruikt het Gemini API TTS-pad met gemini-3.1-flash-tts-preview.

• Standaardstem: Kore
• Authenticatie: messages.tts.providers.google.apiKey, models.providers.google.apiKey, GEMINI_API_KEY of GOOGLE_API_KEY
• Uitvoer: WAV voor normale TTS-bijlagen, Opus voor spraaknotitiedoelen, PCM voor Talk/telefonie
• Spraaknotitie-uitvoer: Google PCM wordt verpakt als WAV en getranscodeerd naar 48 kHz Opus met ffmpeg

Het Gemini TTS-batchpad van Google retourneert gegenereerde audio in de voltooide generateContent-respons. Gebruik voor gesproken gesprekken met de laagste latentie de Google-provider voor realtime spraak, ondersteund door de Gemini Live API, in plaats van batch- TTS.

Google als standaardprovider voor TTS gebruiken:

{  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 gebruikt prompts in natuurlijke taal voor stijlregeling. Stel audioProfile in om een herbruikbare stijlprompt vóór de gesproken tekst te plaatsen. Stel speakerName in wanneer je prompttekst naar een benoemde spreker verwijst.

Gemini API TTS accepteert ook expressieve audiotags tussen vierkante haken in de tekst, zoals [whispers] of [laughs]. Plaats ze in een [[tts:text]]...[[/tts:text]]- blok om tags uit het zichtbare chatantwoord te houden terwijl ze naar TTS worden verzonden:

Here is the clean reply text. [[tts:text]][whispers] Here is the spoken version.[[/tts:text]]

Realtime spraak

De meegeleverde google-Plugin registreert een provider voor realtime spraak, ondersteund door de Gemini Live API voor backend-audiobruggen zoals Voice Call en Google Meet.

Voorbeeld van realtimeconfiguratie voor Voice Call:

{  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",              },            },          },        },      },    },  },}

Voor live-verificatie door maintainers, voer uit: OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts. De smoke dekt ook OpenAI-backend-/WebRTC-paden; de Google-stap maakt dezelfde beperkte Live API-tokenvorm aan die door Control UI Talk wordt gebruikt, opent het browser- WebSocket-eindpunt, verstuurt de initiële setup-payload en wacht op setupComplete.

Geavanceerde configuratie

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

Gerelateerd