Przejdź do głównej treści

​
Gemini Search

OpenClaw obsługuje modele Gemini z wbudowanym osadzaniem w Google Search, które zwraca odpowiedzi syntetyzowane przez AI na podstawie wyników Google Search na żywo wraz z cytowaniami.

​
Pobierz 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 albo skonfiguruj przez:
openclaw configure --section web

​
Konfiguracja

{
  plugins: {
    entries: {
      google: {
        config: {
          webSearch: {
            apiKey: "AIza...", // opcjonalne, jeśli ustawiono GEMINI_API_KEY
            model: "gemini-2.5-flash", // domyślnie
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "gemini",
      },
    },
  },
}
Alternatywa środowiskowa: ustaw GEMINI_API_KEY w środowisku Gateway. W przypadku instalacji gateway umieść ją w ~/.openclaw/.env.

​
Jak to działa

W przeciwieństwie do tradycyjnych providerów wyszukiwania, którzy zwracają listę linków i fragmentów, Gemini używa osadzania w Google Search do tworzenia odpowiedzi syntetyzowanych przez AI z cytowaniami inline. Wyniki obejmują zarówno odpowiedź syntetyzowaną, jak i źródłowe adresy URL.
  • Adresy URL cytowań z osadzania Gemini są automatycznie rozwiązywane z adresów przekierowań Google do bezpośrednich adresów 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 ścisłych domyślnych ustawień SSRF, więc przekierowania do prywatnych/wewnętrznych celów są blokowane.

​
Obsługiwane parametry

Wyszukiwanie Gemini obsługuje query. count jest akceptowane dla współdzielonej zgodności z web_search, ale osadzanie Gemini nadal zwraca jedną odpowiedź syntetyzowaną z cytowaniami zamiast listy N wyników. Filtry specyficzne dla providera, takie jak country, language, freshness i domain_filter, nie są obsługiwane.

​
Wybór modelu

Domyślnym modelem jest gemini-2.5-flash (szybki i opłacalny). Każdy model Gemini, który obsługuje grounding, może być używany przez plugins.entries.google.config.webSearch.model.

​
Powiązane