Przejdź do głównej treści
OpenClaw obsługuje modele Gemini z wbudowanym ugruntowaniem Google Search, które zwraca odpowiedzi syntetyzowane przez AI, oparte na aktualnych wynikach Google Search z cytowaniami.

​
Uzyskaj klucz API

1

Utwórz klucz

Przejdź do Google AI Studio i utwórz klucz API.
2

Zapisz klucz

Ustaw GEMINI_API_KEY w środowisku Gateway, użyj ponownie models.providers.google.apiKey albo skonfiguruj dedykowany klucz wyszukiwania w sieci za pomocą:
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",
      },
    },
  },
}
Pierwszeństwo poświadczeń: wyszukiwanie w sieci Gemini używa najpierw 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 ugruntowania Google Search do tworzenia odpowiedzi syntetyzowanych przez AI z cytowaniami w treści. Wyniki obejmują zarówno zsyntetyzowaną odpowiedź, jak i źródłowe adresy URL.
  • Adresy URL cytowań z ugruntowania Gemini są automatycznie rozwiązywane z adresów przekierowań Google na bezpośrednie adresy URL.
  • Rozwiązywanie przekierowań używa ścieżki ochrony SSRF (HEAD + sprawdzanie 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 ugruntowanie Gemini nadal zwraca jedną zsyntetyzowaną odpowiedź z cytowaniami, a nie listę N wyników. freshness akceptuje day, week, month, year oraz wspólne skróty pd, pw, pm i py. day/pd dodaje do zapytania Gemini instrukcję aktualności zamiast sztywnego zakresu 24 godzin. week, month, year oraz jawne zakresy date_after/date_before ustawiają timeRangeFilter ugruntowania Gemini Google Search. country, language i domain_filter nie są obsługiwane.

​
Wybór modelu

Domyślnym modelem jest gemini-2.5-flash (szybki i opłacalny). Dowolny model Gemini, który obsługuje ugruntowanie, może być używany 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 używa ponownie 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 w podanej postaci po przycięciu końcowych ukośników.

​
Powiązane