Zum Hauptinhalt springen
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

1

Schlüssel erstellen

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

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:
openclaw configure --section web

​
Konfiguration

{
  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.

​
Verwandte Themen