Een API-sleutel verkrijgen
1
Een sleutel maken
Ga naar Google AI Studio en maak een
API-sleutel.
2
De sleutel opslaan
Stel
GEMINI_API_KEY in de Gateway-omgeving in, hergebruik
models.providers.google.apiKey of configureer een afzonderlijke sleutel voor zoeken op het web via:Configuratie
plugins.entries.google.config.webSearch.apiKey, daarna GEMINI_API_KEY
en vervolgens models.providers.google.apiKey. Voor basis-URL’s heeft de afzonderlijke
plugins.entries.google.config.webSearch.baseUrl voorrang op
models.providers.google.baseUrl.
Plaats bij een Gateway-installatie omgevingssleutels in ~/.openclaw/.env.
Werking
In tegenstelling tot traditionele zoekproviders die een lijst met links en fragmenten retourneren, gebruikt Gemini Google Search-grounding om door AI samengestelde antwoorden met bronvermeldingen in de tekst te produceren. De resultaten bevatten zowel het samengestelde antwoord als de URL’s van de bronnen.- URL’s van bronvermeldingen uit Gemini-grounding worden automatisch omgezet van Google- omleidings-URL’s naar directe URL’s via een HEAD-verzoek langs het tegen SSRF beveiligde ophaalpad van OpenClaw (omleidingen volgen, http/https-validatie).
- Bij het omzetten van omleidingen gelden strikte standaardinstellingen tegen SSRF, waardoor omleidingen naar privé- of interne doelen worden geblokkeerd.
Ondersteunde parameters
Gemini-zoeken ondersteuntquery, freshness, date_after en date_before.
count wordt geaccepteerd voor compatibiliteit met de gedeelde web_search, maar Gemini-grounding
retourneert nog steeds één samengesteld 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-
zoekopdracht in plaats van een vast bereik van 24 uur. week, month, year en expliciete
date_after/date_before-bereiken stellen de
timeRangeFilter van Gemini Google Search-grounding 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 de basis-URL
Stelplugins.entries.google.config.webSearch.baseUrl in wanneer Gemini-webzoeken
via een proxy van de beheerder of een aangepast Gemini-compatibel eindpunt moet worden geleid. Als
dit niet is ingesteld, hergebruikt Gemini-webzoeken models.providers.google.baseUrl. Een gewone
https://generativelanguage.googleapis.com-waarde wordt genormaliseerd naar
https://generativelanguage.googleapis.com/v1beta; aangepaste proxypaden blijven behouden
zoals opgegeven nadat afsluitende schuine strepen zijn verwijderd.
Gerelateerd
- Overzicht van zoeken op het web — alle providers en automatische detectie
- Brave Search — gestructureerde resultaten met fragmenten
- Perplexity Search — gestructureerde resultaten + inhoudsextractie