Tools

Gemini-Suche

OpenClaw unterstützt Gemini-Modelle mit integriertem Google-Search-Grounding, das KI-generierte Antworten liefert, die durch aktuelle Google-Suchergebnisse mit Quellenangaben gestützt werden.

API-Schlüssel abrufen

Schlüssel erstellen

Rufen Sie Google AI Studio auf und erstellen Sie einen API-Schlüssel.

Schlüssel speichern

Legen Sie GEMINI_API_KEY in der Gateway-Umgebung fest, verwenden Sie models.providers.google.apiKey erneut oder konfigurieren Sie einen dedizierten Schlüssel für die Websuche über:

bash

openclaw configure --section web

Konfiguration

json5

{  plugins: {    entries: {      google: {        config: {          webSearch: {            apiKey: "AIza...", // optional, wenn GEMINI_API_KEY oder models.providers.google.apiKey festgelegt ist            baseUrl: "https://generativelanguage.googleapis.com/v1beta", // optional; fällt auf models.providers.google.baseUrl zurück            model: "gemini-2.5-flash", // Standardwert          },        },      },    },  },  tools: {    web: {      search: {        provider: "gemini",      },    },  },}

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

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

Funktionsweise

Im Gegensatz zu herkömmlichen Such-Providern, die eine Liste mit Links und Textauszügen zurückgeben, verwendet Gemini Google-Search-Grounding, um KI-generierte Antworten mit Quellenangaben im Text zu erstellen. Die Ergebnisse enthalten sowohl die generierte Antwort als auch die Quell- URLs.

URLs von Quellenangaben aus dem Gemini-Grounding werden über eine HEAD-Anfrage durch den SSRF-geschützten Abrufpfad von OpenClaw automatisch von Google- Weiterleitungs-URLs in direkte URLs aufgelöst (Weiterleitungen werden befolgt, HTTP/HTTPS wird validiert).
Bei der Weiterleitungsauflösung gelten strenge SSRF-Standardeinstellungen, sodass Weiterleitungen an private/interne Ziele blockiert werden.

Unterstützte Parameter

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

count wird aus Kompatibilitätsgründen mit dem gemeinsamen web_search akzeptiert, aber das Gemini-Grounding liefert weiterhin eine einzelne generierte Antwort mit Quellenangaben statt einer Liste mit N Ergebnissen 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, anstatt einen festen 24-Stunden-Zeitraum zu verwenden. week, month, year und explizite Zeiträume mit date_after/date_before legen für das Google-Search-Grounding von Gemini timeRangeFilter fest. 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.

Überschreiben der Basis-URL

Legen Sie plugins.entries.google.config.webSearch.baseUrl fest, wenn die Gemini-Websuche über einen Betreiber-Proxy oder einen benutzerdefinierten Gemini-kompatiblen Endpunkt geleitet werden muss. Wenn diese Einstellung nicht festgelegt ist, verwendet die Gemini-Websuche erneut models.providers.google.baseUrl. Ein einfacher Wert für https://generativelanguage.googleapis.com wird zu https://generativelanguage.googleapis.com/v1beta normalisiert; benutzerdefinierte Proxy-Pfade werden nach dem Entfernen abschließender Schrägstriche wie angegeben beibehalten.