Skip to main content
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

1

Schlüssel erstellen

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

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:

​
Konfiguration

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.

​
Verwandte Themen