Wyszukiwanie w sieci

web_search przeszukuje internet za pomocą skonfigurowanego dostawcy i zwraca znormalizowane wyniki, buforowane według zapytania przez 15 minut (wartość konfigurowalna). OpenClaw zawiera również x_search do wyszukiwania postów w serwisie X (dawniej Twitter) oraz web_fetch do lekkiego pobierania adresów URL. web_fetch zawsze działa lokalnie; web_search jest kierowane przez xAI Responses, gdy dostawcą jest Grok, a x_search zawsze używa xAI Responses.

Szybki start

openclaw configure --section web

await web_search({ query: "OpenClaw plugin SDK" });

await x_search({ query: "dinner recipes" });

Wybór dostawcy

Porównanie dostawców

Automatyczne wykrywanie

Listy dostawców w dokumentacji i procesach konfiguracji są uporządkowane alfabetycznie. Automatyczne wykrywanie używa odrębnej, stałej kolejności pierwszeństwa i wybiera dostawcę wymagającego danych uwierzytelniających (requiresCredential !== false) tylko wtedy, gdy znajdzie skonfigurowane dane. Jeśli nie ustawiono provider, OpenClaw sprawdza dostawców w następującej kolejności i używa pierwszego, który jest gotowy:

Najpierw dostawcy korzystający z API:

1. Brave -- BRAVE_API_KEY lub plugins.entries.brave.config.webSearch.apiKey (kolejność 10)
2. MiniMax Search -- MINIMAX_CODE_PLAN_KEY / MINIMAX_CODING_API_KEY / MINIMAX_OAUTH_TOKEN / MINIMAX_API_KEY lub plugins.entries.minimax.config.webSearch.apiKey (kolejność 15)
3. Gemini -- plugins.entries.google.config.webSearch.apiKey, GEMINI_API_KEY lub models.providers.google.apiKey (kolejność 20)
4. Grok -- OAuth xAI, XAI_API_KEY lub plugins.entries.xai.config.webSearch.apiKey (kolejność 30)
5. Kimi -- KIMI_API_KEY / MOONSHOT_API_KEY lub plugins.entries.moonshot.config.webSearch.apiKey (kolejność 40)
6. Perplexity -- PERPLEXITY_API_KEY / OPENROUTER_API_KEY lub plugins.entries.perplexity.config.webSearch.apiKey (kolejność 50)
7. Firecrawl -- FIRECRAWL_API_KEY lub plugins.entries.firecrawl.config.webSearch.apiKey (kolejność 60)
8. Exa -- EXA_API_KEY lub plugins.entries.exa.config.webSearch.apiKey; opcjonalne ustawienie plugins.entries.exa.config.webSearch.baseUrl zastępuje punkt końcowy Exa (kolejność 65)
9. Tavily -- TAVILY_API_KEY lub plugins.entries.tavily.config.webSearch.apiKey (kolejność 70)
10. Parallel -- płatne API Parallel Search za pośrednictwem PARALLEL_API_KEY lub plugins.entries.parallel.config.webSearch.apiKey; opcjonalne ustawienie plugins.entries.parallel.config.webSearch.baseUrl zastępuje punkt końcowy (kolejność 75)

Następnie dostawcy ze skonfigurowanymi punktami końcowymi:

11. SearXNG -- SEARXNG_BASE_URL lub plugins.entries.searxng.config.webSearch.baseUrl (kolejność 200)

Dostawcy niewymagający klucza, tacy jak Parallel Search (bezpłatne), DuckDuckGo, Ollama Web Search i Codex Hosted Search, nigdy nie są wybierani przez automatyczne wykrywanie, mimo że mają wewnętrzną wartość kolejności. Są używani tylko wtedy, gdy wybierzesz ich jawnie za pomocą tools.web.search.provider lub przez openclaw configure --section web. OpenClaw nie wysyła zarządzanych zapytań web_search do dostawcy niewymagającego klucza tylko dlatego, że nie skonfigurowano żadnego dostawcy korzystającego z API.

Wyjątkiem są modele OpenAI Responses: gdy tools.web.search.provider nie jest ustawione, używają natywnego wyszukiwania internetowego OpenAI zamiast zarządzanych dostawców wymienionych powyżej (patrz niżej). Ustaw tools.web.search.provider na parallel-free (lub innego dostawcę), aby zamiast tego kierować je przez zarządzaną ścieżkę.

Natywne wyszukiwanie internetowe OpenAI

Bezpośrednie modele OpenAI Responses (api: "openai-responses", dostawca openai, bez bazowego adresu URL lub z oficjalnym bazowym adresem URL API OpenAI) automatycznie używają hostowanego przez OpenAI narzędzia web_search, gdy wyszukiwanie internetowe OpenClaw jest włączone i nie wybrano na stałe żadnego zarządzanego dostawcy. Jest to zachowanie kontrolowane przez dostawcę w dołączonym pluginie OpenAI i nie dotyczy bazowych adresów URL serwerów proxy zgodnych z OpenAI ani tras Azure. Ustaw tools.web.search.provider na innego dostawcę, takiego jak brave, aby zachować zarządzane narzędzie web_search dla modeli OpenAI, albo ustaw tools.web.search.enabled: false, aby wyłączyć zarówno wyszukiwanie zarządzane, jak i natywne wyszukiwanie OpenAI.

Natywne wyszukiwanie internetowe Codex

Środowisko uruchomieniowe serwera aplikacji Codex automatycznie używa hostowanego przez Codex narzędzia web_search, gdy wyszukiwanie internetowe jest włączone i nie wybrano żadnego zarządzanego dostawcy. Natywne wyszukiwanie hostowane i dynamiczne zarządzane narzędzie web_search OpenClaw wzajemnie się wykluczają, dlatego wyszukiwanie zarządzane nie może omijać natywnych ograniczeń domen. OpenClaw używa narzędzia zarządzanego, gdy wyszukiwanie hostowane jest niedostępne, jawnie wyłączone lub zastąpione przez wybranego zarządzanego dostawcę. OpenClaw pozostawia samodzielne rozszerzenie web.run Codex wyłączone (features.standalone_web_search: false), ponieważ produkcyjny ruch serwera aplikacji odrzuca zdefiniowaną przez użytkownika przestrzeń nazw web.

• Skonfiguruj natywne wyszukiwanie w tools.web.search.openaiCodex
• Ustaw tools.web.search.provider: "codex", aby udostępnić Codex Hosted Search jako zarządzanego dostawcę web_search dla dowolnego modelu nadrzędnego. Każde wywołanie uruchamia ograniczoną, efemeryczną turę serwera aplikacji Codex i kończy się niepowodzeniem, jeśli Codex nie wyemituje hostowanego elementu webSearch.
• mode: "cached" jest domyślną preferencją, ale Codex rozwiązuje ją jako dostęp na żywo do zasobów zewnętrznych w nieograniczonych turach serwera aplikacji; ustaw "live", aby jawnie zażądać dostępu na żywo
• Ustaw tools.web.search.provider na zarządzanego dostawcę, takiego jak brave, aby zamiast tego używać zarządzanego narzędzia web_search OpenClaw
• Ustaw tools.web.search.openaiCodex.enabled: false, aby zrezygnować z wyszukiwania hostowanego przez Codex; inni zarządzani dostawcy pozostaną dostępni
• Ograniczenie powierzchni natywnych narzędzi Codex również zachowuje dostępność zarządzanego web_search
• Gdy ustawiono allowedDomains, automatyczny zarządzany mechanizm zastępczy odmawia działania, jeśli wyszukiwanie hostowane jest niedostępne, dzięki czemu nie można ominąć natywnej listy dozwolonych domen
• Uruchomienia wyłącznie z modelem LLM, z wyłączonymi narzędziami, wyłączają zarówno wyszukiwanie natywne, jak i zarządzane
• tools.web.search.enabled: false wyłącza zarówno wyszukiwanie zarządzane, jak i natywne

Trwałe zmiany efektywnej polityki wyszukiwania Codex rozpoczynają nowy powiązany wątek, aby już załadowany wątek serwera aplikacji nie mógł zachować nieaktualnego dostępu do wyszukiwania hostowanego. Tymczasowe ograniczenia na pojedynczą turę używają tymczasowego ograniczonego wątku i zachowują istniejące powiązanie do późniejszego wznowienia.

Bezpośredni ruch OpenAI ChatGPT Responses może również używać hostowanego przez OpenAI narzędzia web_search. Ta osobna ścieżka nadal wymaga jawnego włączenia przez tools.web.search.openaiCodex.enabled: true i dotyczy wyłącznie kwalifikujących się modeli openai/* używających api: "openai-chatgpt-responses".

{  tools: {    web: {      search: {        enabled: true,        // Opcjonalnie: używaj Codex Hosted Search również z modelami nadrzędnymi innymi niż Codex.        provider: "codex",        openaiCodex: {          enabled: true,          mode: "cached",          allowedDomains: ["example.com"],          contextSize: "high",          userLocation: {            country: "US",            city: "New York",            timezone: "America/New_York",          },        },      },    },  },}

W przypadku środowisk uruchomieniowych i dostawców, którzy nie obsługują natywnego wyszukiwania Codex, Codex może używać zarządzanego mechanizmu zastępczego web_search za pośrednictwem przestrzeni nazw dynamicznych narzędzi OpenClaw. Użyj jawnie wskazanego zarządzanego dostawcy, gdy zamiast wyszukiwania hostowanego przez Codex potrzebujesz kontroli sieciowych właściwych dla dostawcy OpenClaw.

Wybranie provider: "codex" włącza dołączony plugin codex i stosuje te same ograniczenia tools.web.search.openaiCodex, które pokazano powyżej. Najpierw uwierzytelnij serwer aplikacji Codex poleceniem openclaw models auth login --provider openai. Agent nadrzędny może używać dowolnego modelu lub środowiska uruchomieniowego; tylko ograniczony proces roboczy wyszukiwania działa za pośrednictwem Codex.

Bezpieczeństwo sieci

Wywołania dostawców zarządzanego HTTP web_search używają chronionej ścieżki pobierania OpenClaw, ograniczonej do własnej nazwy hosta bieżącego dostawcy. Wyłącznie dla tej nazwy hosta OpenClaw zezwala na odpowiedzi DNS typu fake-IP z Surge, Clash i sing-box w zakresach 198.18.0.0/15 oraz fc00::/7. Inne prywatne adresy docelowe, local loopback, adresy lokalne dla łącza i adresy metadanych pozostają zablokowane. Codex Hosted Search stanowi wyjątek: jego ograniczony proces roboczy deleguje dostęp do sieci hostowanemu narzędziu web_search serwera aplikacji Codex.

To automatyczne zezwolenie nie dotyczy dowolnych adresów URL web_fetch. W przypadku web_fetch jawnie włącz tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange oraz tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange tylko wtedy, gdy Twój zaufany serwer proxy jest właścicielem tych syntetycznych zakresów.

Konfiguracja

{  tools: {    web: {      search: {        enabled: true, // domyślnie: true        provider: "brave", // lub pomiń, aby użyć automatycznego wykrywania        maxResults: 5,        timeoutSeconds: 30,        cacheTtlMinutes: 15,      },    },  },}

Konfiguracja właściwa dla dostawcy (klucze API, bazowe adresy URL, tryby) znajduje się w plugins.entries.<plugin>.config.webSearch.*. Gemini może również ponownie wykorzystywać models.providers.google.apiKey i models.providers.google.baseUrl jako mechanizmy zastępcze o niższym priorytecie po dedykowanej konfiguracji wyszukiwania internetowego i GEMINI_API_KEY. Przykłady znajdziesz na stronach dostawców. Grok może również ponownie użyć profilu uwierzytelniania OAuth xAI utworzonego przez openclaw models auth login --provider xai --method oauth; konfiguracja klucza API pozostaje mechanizmem zastępczym.

Wartość tools.web.search.provider jest weryfikowana względem identyfikatorów dostawców wyszukiwania internetowego zadeklarowanych w manifestach dołączonych i zainstalowanych pluginów. Literówka taka jak "brvae" powoduje błąd walidacji konfiguracji zamiast cichego przejścia do automatycznego wykrywania. Jeśli skonfigurowany dostawca ma tylko nieaktualne ślady pluginu, takie jak pozostały blok plugins.entries.<plugin> po odinstalowaniu pluginu innej firmy, OpenClaw zachowuje odporność procesu uruchamiania i zgłasza ostrzeżenie, aby umożliwić ponowną instalację pluginu lub uruchomienie openclaw doctor --fix w celu wyczyszczenia nieaktualnej konfiguracji.

Wybór dostawcy mechanizmu zastępczego web_fetch odbywa się osobno:

• wybierz go za pomocą tools.web.fetch.provider
• albo pomiń to pole i pozwól OpenClaw automatycznie wykryć pierwszego gotowego dostawcę web-fetch na podstawie skonfigurowanych danych uwierzytelniających
• web_fetch poza piaskownicą może używać zainstalowanych dostawców pluginów, którzy deklarują contracts.webFetchProviders; pobieranie w piaskownicy dopuszcza dołączonych dostawców oraz zweryfikowane instalacje oficjalnych pluginów, ale wyklucza zewnętrzne pluginy innych firm
• oficjalny plugin Firecrawl jest obecnie jedynym dołączonym dostawcą webFetchProviders i konfiguruje się go w plugins.entries.firecrawl.config.webFetch.*

Gdy podczas openclaw onboard lub openclaw configure --section web wybierzesz Kimi, OpenClaw może również zapytać o:

• region API Moonshot (https://api.moonshot.ai/v1 lub https://api.moonshot.cn/v1)
• domyślny model wyszukiwania internetowego Kimi (domyślnie kimi-k2.6)

Dla x_search skonfiguruj plugins.entries.xai.config.xSearch.*. Używa on tego samego profilu uwierzytelniania xAI co czat albo XAI_API_KEY / danych uwierzytelniających wyszukiwania internetowego pluginu używanych przez wyszukiwanie internetowe Grok. Starsza konfiguracja tools.web.x_search.* jest automatycznie migrowana przez openclaw doctor --fix. Gdy podczas openclaw onboard lub openclaw configure --section web wybierzesz Grok, OpenClaw oferuje również opcjonalną konfigurację x_search z tymi samymi danymi uwierzytelniającymi bezpośrednio po zakończeniu konfiguracji Grok. Jest to osobny kolejny krok w ścieżce Grok, a nie osobny wybór dostawcy wyszukiwania internetowego najwyższego poziomu. Jeśli wybierzesz innego dostawcę, OpenClaw nie wyświetli monitu x_search.

Przechowywanie kluczy API

{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "YOUR_KEY", // pragma: allowlist secret          },        },      },    },  },}

export BRAVE_API_KEY="YOUR_KEY"

Parametry narzędzia

x_search

x_search przeszukuje wpisy w X (dawniej Twitter) za pomocą xAI i zwraca odpowiedzi zsyntetyzowane przez AI wraz z cytowaniami. Akceptuje zapytania w języku naturalnym i opcjonalne filtry strukturalne. OpenClaw tworzy wbudowane narzędzie xAI x_search dla każdego żądania, zamiast utrzymywać je jako stale zarejestrowane, dlatego jest ono aktywne tylko w turze, która faktycznie je wywołuje.

Konfiguracja x_search

Gdy pominięto enabled, narzędzie x_search jest udostępniane tylko wtedy, gdy dostawcą aktywnego modelu jest xai i można uzyskać dane uwierzytelniające xAI. W przypadku aktywnego modelu ze znanym dostawcą innym niż xAI ustaw plugins.entries.xai.config.xSearch.enabled na true, aby włączyć używanie między dostawcami. Jeśli dostawca aktywnego modelu nie jest określony lub nie można go rozpoznać, narzędzie pozostaje ukryte. Ustaw enabled na false, aby wyłączyć je dla każdego dostawcy. Dane uwierzytelniające xAI są zawsze wymagane.

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true, // wymagane dla znanego dostawcy modelu innego niż xAI            model: "grok-4.3",            baseUrl: "https://api.x.ai/v1", // opcjonalne, zastępuje webSearch.baseUrl            inlineCitations: false,            maxTurns: 2,            timeoutSeconds: 30,            cacheTtlMinutes: 15,          },          webSearch: {            apiKey: "xai-...", // opcjonalne, jeśli ustawiono profil uwierzytelniania xAI lub XAI_API_KEY            baseUrl: "https://api.x.ai/v1", // opcjonalny, współdzielony bazowy adres URL xAI Responses          },        },      },    },  },}

Narzędzie x_search wysyła żądania POST do <baseUrl>/responses, gdy ustawiono plugins.entries.xai.config.xSearch.baseUrl. Jeśli to pole pominięto, używane są kolejno plugins.entries.xai.config.webSearch.baseUrl, starsze ustawienie tools.web.search.grok.baseUrl, a na końcu publiczny punkt końcowy xAI (https://api.x.ai/v1).

Parametry x_search

allowed_x_handles i excluded_x_handles wzajemnie się wykluczają.

Przykład x_search

await x_search({  query: "przepisy na kolację",  allowed_x_handles: ["nytfood"],  from_date: "2026-03-01",});

// Statystyki poszczególnych wpisów: w miarę możliwości użyj dokładnego adresu URL statusu lub identyfikatora statusuawait x_search({  query: "https://x.com/huntharo/status/1905678901234567890",});

Przykłady

// Podstawowe wyszukiwanieawait web_search({ query: "SDK pluginów OpenClaw" }); // Wyszukiwanie dotyczące języka niemieckiegoawait web_search({ query: "TV online schauen", country: "DE", language: "de" }); // Najnowsze wyniki (z ostatniego tygodnia)await web_search({ query: "rozwój sztucznej inteligencji", freshness: "week" }); // Zakres datawait web_search({  query: "badania nad klimatem",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Filtrowanie domen (tylko Perplexity)await web_search({  query: "recenzje produktów",  domain_filter: ["-reddit.com", "-pinterest.com"],});

Profile narzędzi

Jeśli używasz profili narzędzi lub list dozwolonych elementów, dodaj web_search, x_search lub group:web:

{  tools: {    allow: ["web_search", "x_search"],    // lub: allow: ["group:web"]  (obejmuje web_search, x_search i web_fetch)  },}

Powiązane

• Pobieranie treści internetowych -- pobieranie adresu URL i wyodrębnianie treści możliwej do odczytania
• Przeglądarka internetowa -- pełna automatyzacja przeglądarki dla witryn intensywnie korzystających z JS
• Wyszukiwanie Grok -- Grok jako dostawca web_search
• Wyszukiwanie internetowe Ollama -- wyszukiwanie internetowe bez klucza za pośrednictwem hosta Ollama