Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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