Gemini zoeken

OpenClaw ondersteunt Gemini-modellen met ingebouwde Google Search-grounding, die door AI gesynthetiseerde antwoorden retourneert, ondersteund door live Google Search-resultaten met bronvermeldingen.

# Een API-sleutel verkrijgen

openclaw configure --section web

# Configuratie

{
  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", // optional; falls back to models.providers.google.baseUrl
            model: "gemini-2.5-flash", // default
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "gemini",
      },
    },
  },
}

Volgorde van referenties: Gemini-webzoeken gebruikt eerst plugins.entries.google.config.webSearch.apiKey, 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.

Plaats omgevingssleutels voor een Gateway-installatie in ~/.openclaw/.env.

# Hoe het werkt

In tegenstelling tot traditionele zoekproviders die een lijst met links en fragmenten 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-bewakingspad (HEAD + omleidingscontroles + http/https-validatie) voordat de uiteindelijke bronvermeldings-URL wordt geretourneerd.
• Omleidingsresolutie gebruikt strikte SSRF-standaardwaarden, dus omleidingen naar private/interne doelen worden geblokkeerd.

# Ondersteunde parameters

Gemini-zoeken ondersteunt query, freshness, date_after en date_before.

count wordt geaccepteerd voor compatibiliteit met gedeelde web_search, 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. OpenClaw zet deze waarden, of een expliciet date_after/date_before-bereik, om naar Gemini Google Search-grounding's timeRangeFilter. 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.

# Basis-URL-overschrijvingen

Stel plugins.entries.google.config.webSearch.baseUrl in wanneer Gemini-webzoeken via een operatorproxy of aangepast Gemini-compatibel eindpunt moet verlopen. Als dat 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 zoals opgegeven nadat afsluitende schuine strepen zijn verwijderd.

# Gerelateerd

• Web Search-overzicht -- alle providers en automatische detectie
• Brave Search -- gestructureerde resultaten met fragmenten
• Perplexity Search -- gestructureerde resultaten + inhoudsextractie