Tools

Gemini-Suche

OpenClaw unterstützt Gemini-Modelle mit integriertem Google Search grounding, das KI-synthetisierte Antworten zurückgibt, die durch Live-Ergebnisse von Google Search mit Quellenangaben belegt sind.

API-Schlüssel abrufen

Schlüssel erstellen

Gehen Sie zu Google AI Studio und erstellen Sie einen API-Schlüssel.

Schlüssel speichern

Setzen Sie GEMINI_API_KEY in der Gateway-Umgebung, verwenden Sie models.providers.google.apiKey erneut oder konfigurieren Sie einen dedizierten Websuchschlüssel über:

bash

openclaw configure --section web

Konfiguration

json5

{  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",      },    },  },}

Priorität der Anmeldedaten: Die Gemini-Websuche verwendet zuerst plugins.entries.google.config.webSearch.apiKey, dann GEMINI_API_KEY, danach models.providers.google.apiKey. Bei Basis-URLs hat die dedizierte plugins.entries.google.config.webSearch.baseUrl Vorrang vor models.providers.google.baseUrl.

Legen Sie bei einer Gateway-Installation Umgebungsschlüssel in ~/.openclaw/.env ab.

Funktionsweise

Anders als herkömmliche Search-Provider, die eine Liste von Links und Snippets zurückgeben, nutzt Gemini Google Search grounding, um KI-synthetisierte Antworten mit Inline-Quellenangaben zu erzeugen. Die Ergebnisse enthalten sowohl die synthetisierte Antwort als auch die Quell- URLs.

Quellen-URLs aus Gemini grounding werden automatisch von Google- Weiterleitungs-URLs in direkte URLs aufgelöst.
Die Auflösung von Weiterleitungen verwendet den SSRF-Schutzpfad (HEAD + Weiterleitungsprüfungen + http/https-Validierung), bevor die endgültige Quellen-URL zurückgegeben wird.
Die Auflösung von Weiterleitungen verwendet strikte SSRF-Standardeinstellungen, sodass Weiterleitungen zu privaten/internen Zielen blockiert werden.

Unterstützte Parameter

Die Gemini-Suche unterstützt query, freshness, date_after und date_before.

count wird für die gemeinsame web_search-Kompatibilität akzeptiert, aber Gemini grounding gibt weiterhin eine synthetisierte Antwort mit Quellenangaben statt einer Ergebnisliste mit N Treffern zurück.

freshness akzeptiert day, week, month, year sowie die gemeinsamen Kurzformen pd, pw, pm und py. day/pd fügt der Gemini- Abfrage eine Aktualitätsanweisung hinzu statt eines festen 24-Stunden-Zeitraums. week, month, year und explizite date_after/date_before-Bereiche setzen den timeRangeFilter von Gemini Google Search grounding. country, language und domain_filter werden nicht unterstützt.

Modellauswahl

Das Standardmodell ist gemini-2.5-flash (schnell und kosteneffizient). Jedes Gemini- Modell, das grounding unterstützt, kann über plugins.entries.google.config.webSearch.model verwendet werden.

Überschreibungen der Basis-URL

Setzen Sie plugins.entries.google.config.webSearch.baseUrl, wenn die Gemini-Websuche über einen Operator-Proxy oder einen benutzerdefinierten Gemini-kompatiblen Endpunkt geleitet werden muss. Wenn dies nicht gesetzt ist, verwendet die Gemini-Websuche models.providers.google.baseUrl erneut. Ein einfacher Wert https://generativelanguage.googleapis.com wird zu https://generativelanguage.googleapis.com/v1beta normalisiert; benutzerdefinierte Proxy-Pfade bleiben nach dem Entfernen nachgestellter Schrägstriche unverändert.