Een API-sleutel ophalen
Een sleutel maken
Ga naar Google AI Studio en maak een
API-sleutel.
Configuratie
plugins.entries.google.config.webSearch.apiKey eerst, daarna GEMINI_API_KEY,
en daarna models.providers.google.apiKey. Voor basis-URL’s krijgt de speciale
plugins.entries.google.config.webSearch.baseUrl voorrang op
models.providers.google.baseUrl.
Voor een Gateway-installatie plaats je omgevingssleutels in ~/.openclaw/.env.
Hoe het werkt
In tegenstelling tot traditionele zoekproviders die een lijst met links en snippets retourneren, gebruikt Gemini Google Search-grounding om door AI gesynthetiseerde antwoorden met inline bronvermeldingen te produceren. De resultaten bevatten zowel het gesynthetiseerde antwoord als de bron- URL’s.- Bronvermeldings-URL’s uit Gemini-grounding worden automatisch omgezet van Google- omleidings-URL’s naar directe URL’s.
- Omleidingsresolutie gebruikt het SSRF-beveiligingspad (HEAD + omleidingscontroles + http/https-validatie) voordat de uiteindelijke bronvermeldings-URL wordt geretourneerd.
- Omleidingsresolutie gebruikt strikte SSRF-standaardinstellingen, zodat omleidingen naar privé/interne doelen worden geblokkeerd.
Ondersteunde parameters
Gemini-zoeken ondersteuntquery, freshness, date_after en date_before.
count wordt geaccepteerd voor gedeelde web_search-compatibiliteit, maar Gemini-grounding
retourneert nog steeds één gesynthetiseerd antwoord met bronvermeldingen in plaats van een lijst met N
resultaten.
freshness accepteert day, week, month, year en de gedeelde snelkoppelingen
pd, pw, pm en py. day/pd voegt een recentheidsinstructie toe aan de Gemini-
query in plaats van een harde periode van 24 uur. week, month, year en expliciete
date_after/date_before-bereiken stellen Gemini Google Search-grounding’s
timeRangeFilter in. country, language en domain_filter worden niet ondersteund.
Modelselectie
Het standaardmodel isgemini-2.5-flash (snel en kosteneffectief). Elk Gemini-
model dat grounding ondersteunt, kan worden gebruikt via
plugins.entries.google.config.webSearch.model.
Overschrijvingen van basis-URL’s
Stelplugins.entries.google.config.webSearch.baseUrl in wanneer Gemini-webzoekfunctie
via een operatorproxy of aangepast Gemini-compatibel eindpunt moet lopen. Als
dat niet is ingesteld, hergebruikt Gemini-webzoekfunctie models.providers.google.baseUrl. Een gewone
https://generativelanguage.googleapis.com-waarde wordt genormaliseerd naar
https://generativelanguage.googleapis.com/v1beta; aangepaste proxypaden blijven
zoals opgegeven nadat afsluitende slashes zijn verwijderd.
Gerelateerd
- Overzicht van Web Search — alle providers en automatische detectie
- Brave Search — gestructureerde resultaten met snippets
- Perplexity Search — gestructureerde resultaten + inhoudsextractie