Wyszukiwanie w internecie — narzedzie Web w OpenClaw

Wprowadzenie

Narzedzie web_search umozliwia wyszukiwanie w internecie za posrednictwem skonfigurowanych dostawcow i zwraca wyniki z cache (domyslnie 15-minutowy). OpenClaw oferuje takze x_search do wyszukiwania postow na X/Twitter oraz web_fetch do pobierania konkretnych adresow URL.

Wazne: web_search to lekkie narzedzie HTTP, a nie automatyzacja przegladarki. Do stron wymagajacych JavaScriptu lub logowania uzyj narzedzia przegladarki.

Szybki start

1. Wybierz dostawce — niektorzy nie wymagaja klucza API (np. DuckDuckGo)
2. Skonfiguruj — uruchom openclaw configure --section web lub ustaw zmienne srodowiskowe, np. BRAVE_API_KEY
3. Uzyj — wywolaj narzedzie w kodzie lub naturalnym jezykiem

Dostepni dostawcy

Wyniki z synteza AI i cytatami

• Gemini — grounding w wyszukiwarce Google
• Grok — grounding xAI
• Kimi/Moonshot — synteza AI odpowiedzi

Wyniki strukturalne

• Brave Search — tryb llm-context, filtry krajowe/jezykowe
• DuckDuckGo — bez klucza API, integracja HTML
• Exa — wyszukiwanie neuronowe + slownikowe z ekstrakcja tresci
• Firecrawl — wyniki strukturalne, wsparcie scrapingu
• Perplexity — kontrola ekstrakcji tresci, filtry domen
• Tavily — glebokosc wyszukiwania, filtrowanie tematyczne

Self-hosted / bez klucza

• Ollama Web Search — wymaga lokalnej instancji Ollama
• SearXNG — metawyszukiwarka agregujaca wyniki

Priorytet automatycznego wykrywania

Gdy nie podano dostawcy, OpenClaw sprawdza ich w kolejnosci priorytetow: Brave (10), MiniMax (15), Gemini (20), Grok (30), Kimi (40), Perplexity (50), Firecrawl (60), Exa (65), Tavily (70), a nastepnie fallbacki bez klucza: DuckDuckGo (100), Ollama (110), SearXNG (200).

Parametry narzedzia

• query — frazy wyszukiwania (wymagane)
• count — liczba wynikow (1–10, domyslnie 5)
• country — filtrowanie geograficzne (kod ISO 2-literowy)
• language — preferencja jezykowa (kod ISO 639-1)
• freshness — filtr czasowy: day, week, month, year
• date_after / date_before — zakres dat (format YYYY-MM-DD)

Wyszukiwanie na X (x_search)

Narzedzie x_search przeszukuje posty na platformie X/Twitter za pomoca xAI i zwraca odpowiedzi z synteza AI i cytatami. Dodatkowe parametry obejmuja: allowed_x_handles, excluded_x_handles, filtry dat oraz opcje rozumienia obrazow i wideo.

Konfiguracja podstawowa

{
  tools: {
    web: {
      search: {
        enabled: true,
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
      },
    },
  },
}