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

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

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

Bei einer Gateway-Installation legen Sie Env-Schlüssel in ~/.openclaw/.env ab.

# Funktionsweise

Im Gegensatz zu traditionellen Such-Providern, die eine Liste von Links und Snippets zurückgeben, verwendet 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 Weiterleitungsauflösung verwendet den SSRF-Schutzpfad (HEAD + Weiterleitungsprüfungen + http/https-Validierung), bevor die finale Quellen-URL zurückgegeben wird.
• Die Weiterleitungsauflösung verwendet strikte SSRF-Standards, 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 zurück statt einer Liste mit N Ergebnissen.

freshness akzeptiert day, week, month, year sowie die gemeinsamen Kurzformen pd, pw, pm und py. OpenClaw wandelt diese Werte oder einen expliziten Bereich aus date_after/date_before in den timeRangeFilter von Gemini Google Search-Grounding um. 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.

# Basis-URL-Overrides

Legen Sie plugins.entries.google.config.webSearch.baseUrl fest, wenn die Gemini-Websuche über einen Operator-Proxy oder einen benutzerdefinierten Gemini-kompatiblen Endpunkt geleitet werden muss. Wenn dies nicht festgelegt 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 abschließender Schrägstriche wie angegeben erhalten.

# Verwandte Themen

• Web Search-Überblick -- alle Provider und automatische Erkennung
• Brave Search -- strukturierte Ergebnisse mit Snippets
• Perplexity Search -- strukturierte Ergebnisse + Inhaltsextraktion