Wyszukiwanie Gemini

OpenClaw obsługuje modele Gemini z wbudowanym Google Search grounding, które zwraca syntetyzowane przez AI odpowiedzi oparte na bieżących wynikach Google Search z cytowaniami.

# Uzyskaj klucz API

openclaw configure --section web

# Konfiguracja

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

Priorytet danych uwierzytelniających: wyszukiwanie w sieci Gemini najpierw używa plugins.entries.google.config.webSearch.apiKey, następnie GEMINI_API_KEY, a potem models.providers.google.apiKey. W przypadku bazowych adresów URL dedykowane plugins.entries.google.config.webSearch.baseUrl ma pierwszeństwo przed models.providers.google.baseUrl.

W instalacji Gateway umieść klucze środowiskowe w ~/.openclaw/.env.

# Jak to działa

W przeciwieństwie do tradycyjnych dostawców wyszukiwania, którzy zwracają listę linków i fragmentów, Gemini używa Google Search grounding do generowania syntetyzowanych przez AI odpowiedzi z cytowaniami w treści. Wyniki zawierają zarówno zsyntetyzowaną odpowiedź, jak i źródłowe adresy URL.

• Adresy URL cytowań z Gemini grounding są automatycznie rozwiązywane z adresów przekierowań Google na bezpośrednie adresy URL.
• Rozwiązywanie przekierowań używa ścieżki ochrony przed SSRF (HEAD + kontrole przekierowań + walidacja http/https) przed zwróceniem końcowego adresu URL cytowania.
• Rozwiązywanie przekierowań używa rygorystycznych domyślnych ustawień SSRF, więc przekierowania do prywatnych/wewnętrznych celów są blokowane.

# Obsługiwane parametry

Wyszukiwanie Gemini obsługuje query, freshness, date_after i date_before.

count jest akceptowane dla zgodności ze wspólnym web_search, ale Gemini grounding nadal zwraca jedną zsyntetyzowaną odpowiedź z cytowaniami zamiast listy N wyników.

freshness akceptuje day, week, month, year oraz wspólne skróty pd, pw, pm i py. OpenClaw konwertuje te wartości lub jawny zakres date_after/date_before na timeRangeFilter w Gemini Google Search grounding. country, language i domain_filter nie są obsługiwane.

# Wybór modelu

Domyślny model to gemini-2.5-flash (szybki i opłacalny). Dowolny model Gemini, który obsługuje grounding, może być użyty przez plugins.entries.google.config.webSearch.model.

# Nadpisania bazowego adresu URL

Ustaw plugins.entries.google.config.webSearch.baseUrl, gdy wyszukiwanie w sieci Gemini musi przechodzić przez proxy operatora lub niestandardowy punkt końcowy zgodny z Gemini. Jeśli ta wartość nie jest ustawiona, wyszukiwanie w sieci Gemini ponownie używa models.providers.google.baseUrl. Zwykła wartość https://generativelanguage.googleapis.com jest normalizowana do https://generativelanguage.googleapis.com/v1beta; niestandardowe ścieżki proxy są zachowywane zgodnie z podaną wartością po usunięciu końcowych ukośników.

# Powiązane

• Omówienie Web Search -- wszyscy dostawcy i automatyczne wykrywanie
• Brave Search -- ustrukturyzowane wyniki z fragmentami
• Perplexity Search -- ustrukturyzowane wyniki + ekstrakcja treści