Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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 speciale webzoeksleutel via:
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