Google (Gemini) - OpenClaw

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.

API-sleutel
Gemini CLI (OAuth)

Het meest geschikt voor: standaardtoegang tot de Gemini API via Google AI Studio.

Onboarding uitvoeren

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

Of geef de sleutel direct door:

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

Een standaardmodel instellen

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

Controleren of het model beschikbaar is

openclaw models list --provider google

De omgevingsvariabelen GEMINI_API_KEY en GOOGLE_API_KEY worden allebei geaccepteerd. Gebruik degene die je al hebt geconfigureerd.

Het meest geschikt voor: het hergebruiken van een bestaande Gemini CLI-login via PKCE OAuth in plaats van een aparte API-sleutel.

De provider google-gemini-cli is een onofficiële integratie. Sommige gebruikers melden accountbeperkingen wanneer ze OAuth op deze manier gebruiken. Gebruik dit op eigen risico.

De Gemini CLI installeren

De lokale opdracht gemini moet beschikbaar zijn op PATH.

# Homebrew
brew install gemini-cli

# or npm
npm install -g @google/gemini-cli

OpenClaw ondersteunt zowel Homebrew-installaties als globale npm-installaties, inclusief veelvoorkomende Windows/npm-indelingen.

Inloggen via OAuth

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

Controleren of het model beschikbaar is

openclaw models list --provider google

Standaardmodel: google/gemini-3.1-pro-preview
Runtime: google-gemini-cli
Alias: gemini-cli

De Gemini API-model-id van Gemini 3.1 Pro is gemini-3.1-pro-preview. OpenClaw accepteert de kortere google/gemini-3.1-pro als handige alias en normaliseert die vóór provider-aanroepen.Omgevingsvariabelen:

OPENCLAW_GEMINI_OAUTH_CLIENT_ID
OPENCLAW_GEMINI_OAUTH_CLIENT_SECRET

(Of de GEMINI_CLI_*-varianten.)

Als Gemini CLI OAuth-aanvragen mislukken na het inloggen, stel dan GOOGLE_CLOUD_PROJECT of GOOGLE_CLOUD_PROJECT_ID in op de Gateway-host en probeer het opnieuw.

Als inloggen mislukt voordat de browserflow begint, controleer dan of de lokale opdracht gemini is geïnstalleerd en op PATH staat.

google-gemini-cli/*-modelverwijzingen zijn verouderde compatibiliteitsaliassen. Nieuwe configuraties moeten google/*-modelverwijzingen plus de runtime google-gemini-cli gebruiken wanneer ze lokale Gemini CLI-uitvoering willen.

Mogelijkheden

Mogelijkheid	Ondersteund
Chatvoltooiingen	Ja
Afbeeldingsgeneratie	Ja
Muziekgeneratie	Ja
Tekst-naar-spraak	Ja
Realtime spraak	Ja (Google Live API)
Afbeeldingsbegrip	Ja
Audiotranscriptie	Ja
Videobegrip	Ja
Webzoekopdracht (Grounding)	Ja
Denken/redeneren	Ja (Gemini 2.5+ / Gemini 3+)
Gemma 4-modellen	Ja

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.

Gemini 3-modellen gebruiken thinkingLevel in plaats van thinkingBudget. OpenClaw wijst redeneerinstellingen voor Gemini 3, Gemini 3.1 en gemini-*-latest-aliassen toe aan thinkingLevel, zodat standaardruns en runs met lage latentie geen uitgeschakelde thinkingBudget-waarden verzenden./think adaptive behoudt de dynamische denksemantiek van Google in plaats van een vast OpenClaw-niveau te kiezen. Gemini 3 en Gemini 3.1 laten een vaste thinkingLevel weg zodat Google het niveau kan kiezen; Gemini 2.5 verzendt de dynamische sentinel van Google thinkingBudget: -1.Gemma 4-modellen (bijvoorbeeld gemma-4-26b-a4b-it) ondersteunen denkmodus. OpenClaw herschrijft thinkingBudget naar een ondersteund Google-thinkingLevel voor Gemma 4. Door denken op off te zetten blijft denken uitgeschakeld in plaats van te worden toegewezen aan MINIMAL.

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

Zie Afbeeldingsgeneratie voor gedeelde toolparameters, providerselectie en failovergedrag.

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

Zie Videogeneratie voor gedeelde toolparameters, providerselectie en failovergedrag.

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

Zie Muziekgeneratie voor gedeelde toolparameters, providerselectie en failovergedrag.

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]]

Een Google Cloud Console API-sleutel die is beperkt tot de Gemini API is geldig voor deze provider. Dit is niet het aparte Cloud Text-to-Speech API-pad.

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.

Instelling	Configuratiepad	Standaard
Model	`plugins.entries.voice-call.config.realtime.providers.google.model`	`gemini-2.5-flash-native-audio-preview-12-2025`
Stem	`...google.voice`	`Kore`
Temperatuur	`...google.temperature`	(niet ingesteld)
VAD-startgevoeligheid	`...google.startSensitivity`	(niet ingesteld)
VAD-eindgevoeligheid	`...google.endSensitivity`	(niet ingesteld)
Stilteduur	`...google.silenceDurationMs`	(niet ingesteld)
Activiteitsafhandeling	`...google.activityHandling`	Google-standaard, `start-of-activity-interrupts`
Beurtdekking	`...google.turnCoverage`	Google-standaard, `only-activity`
Automatische VAD uitschakelen	`...google.automaticActivityDetectionDisabled`	`false`
Sessiehervatting	`...google.sessionResumption`	`true`
Contextcompressie	`...google.contextWindowCompression`	`true`
API-sleutel	`...google.apiKey`	Valt terug op `models.providers.google.apiKey`, `GEMINI_API_KEY` of `GOOGLE_API_KEY`

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

Google Live API gebruikt bidirectionele audio en functieaanroepen via een WebSocket. OpenClaw past audio van telefonie-/Meet-bridges aan naar Gemini’s PCM Live API-stream en houdt toolaanroepen op het gedeelde realtime-spraakcontract. Laat temperature niet ingesteld tenzij je samplingwijzigingen nodig hebt; OpenClaw laat niet-positieve waarden weg omdat Google Live transcripties zonder audio kan retourneren voor temperature: 0. Gemini API-transcriptie is ingeschakeld zonder languageCodes; de huidige Google SDK wijst taalcodehints op dit API-pad af.

Control UI Talk ondersteunt Google Live-browsersessies met beperkte tokens voor eenmalig gebruik. Backend-only realtime-spraakproviders kunnen ook via het generieke Gateway-relaytransport draaien, waarbij providerreferenties op de Gateway blijven.

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

Direct Gemini-cachehergebruik

Voor directe Gemini API-runs (api: "google-generative-ai") geeft OpenClaw een geconfigureerde cachedContent-handle door aan Gemini-verzoeken.

Configureer per-model- of globale parameters met cachedContent of de oudere cached_content
Als beide aanwezig zijn, wint cachedContent
Voorbeeldwaarde: cachedContents/prebuilt-context
Gemini-cache-hitgebruik wordt genormaliseerd naar OpenClaw cacheRead vanuit upstream cachedContentTokenCount

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

Gebruiksnotities voor Gemini CLI JSON

Bij gebruik van de OAuth-provider google-gemini-cli normaliseert OpenClaw de CLI JSON-uitvoer als volgt:

Antwoordtekst komt uit het CLI JSON-veld response.
Gebruik valt terug op stats wanneer de CLI usage leeg laat.
stats.cached wordt genormaliseerd naar OpenClaw cacheRead.
Als stats.input ontbreekt, leidt OpenClaw invoertokens af uit stats.input_tokens - stats.cached.

Omgeving en daemoninstelling

Als de Gateway als daemon draait (launchd/systemd), zorg er dan voor dat GEMINI_API_KEY beschikbaar is voor dat proces (bijvoorbeeld in ~/.openclaw/.env of via env.shellEnv).

Gerelateerd

Modelselectie

Providers, modelrefs en failovergedrag kiezen.

Afbeeldingen genereren

Gedeelde parameters voor afbeeldingstools en providerselectie.

Video genereren

Gedeelde parameters voor videotools en providerselectie.

Muziek genereren

Gedeelde parameters voor muziektools en providerselectie.

Documentation Index

​Aan de slag

​Mogelijkheden

​Webzoekopdracht

​Afbeeldingsgeneratie

​Videogeneratie

​Muziekgeneratie

​Tekst-naar-spraak

​Realtime spraak

​Geavanceerde configuratie

​Gerelateerd

Modelselectie

Afbeeldingen genereren

Video genereren

Muziek genereren

Aan de slag

Mogelijkheden

Webzoekopdracht

Afbeeldingsgeneratie

Videogeneratie

Muziekgeneratie

Tekst-naar-spraak

Realtime spraak

Geavanceerde configuratie

Gerelateerd