// dokumentacja openclaw

Brave Search API w OpenClaw

Wprowadzenie

OpenClaw integruje sie z Brave Search API jako dostawca wyszukiwania internetowego, oferujac zarowno standardowe wyszukiwanie web, jak i tryb LLM Context zoptymalizowany dla modeli AI.

Konfiguracja

Uzyskanie klucza API

  1. Zaloz konto na portalu API Brave Search
  2. Wybierz plan Search
  3. Wygeneruj klucz API
  4. Zapisz klucz jako BRAVE_API_KEY w srodowisku Gateway

Struktura konfiguracji

Ustawienia znajduja sie w plugins.entries.brave.config.webSearch.*. Stare sciezki konfiguracyjne sa nadal obslugiwane. Dostepne sa dwa tryby transportu:

  • web — standardowe wyniki z tytulami i adresami URL
  • llm-context — wstepnie wyekstrahowane fragmenty tekstu zoptymalizowane do groundingu AI

Dostepne parametry

Zapytania wyszukiwania akceptuja opcjonalne filtry:

  • Kody krajow — ograniczenie wynikow do konkretnego regionu
  • Preferencje jezykowe — wyniki w wybranym jezyku
  • Okna swiezosci — day, week, month, year
  • Zakresy dat — precyzyjne ograniczenie czasowe wynikow
  • Liczba wynikow — parametr count (1–10, domyslnie 5)

Przyklady uzycia

Narzedzie obsluguje wyszukiwanie z filtrami krajowymi, filtrowanie najnowszych tresci za pomoca ustawien swiezosci oraz zapytania z zakresem dat dla wynikow historycznych.

// Wyszukiwanie z filtrem krajowym
await web_search({ query: "najlepsze restauracje", country: "PL" });

// Wyniki z ostatniego tygodnia
await web_search({ query: "nowosci AI", freshness: "week" });

// Zakres dat
await web_search({
  query: "badania klimatyczne",
  date_after: "2025-01-01",
  date_before: "2025-06-30",
});

Wazne ograniczenia

  • Tryb LLM Context nie obsluguje preferencji jezyka interfejsu, filtrow swiezosci ani parametrow dat
  • Wyniki sa cache'owane domyslnie przez 15 minut
  • Kredyt 5$ miesiecznie pokrywa okolo 1000 zapytan przy aktualnym cenniku
Wróc do dokumentacji