Gemini-zoekopdracht

OpenClaw ondersteunt Gemini-modellen met ingebouwde Google Search-grounding, die door AI samengestelde antwoorden retourneert, onderbouwd met actuele Google Search-resultaten en bronvermeldingen.

Een API-sleutel verkrijgen

openclaw configure --section web

Configuratie

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // optioneel als GEMINI_API_KEY of models.providers.google.apiKey is ingesteld            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // optioneel; valt terug op models.providers.google.baseUrl            model: "gemini-2.5-flash", // standaard          },        },      },    },  },  tools: {    web: {      search: {        provider: "gemini",      },    },  },}

Prioriteit van inloggegevens: Gemini-webzoeken gebruikt eerst 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 ondersteunt query, 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 is gemini-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

Stel plugins.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