Wyszukiwanie w sieci

Narzędzie web_search przeszukuje internet przy użyciu skonfigurowanego dostawcy i zwraca wyniki. Wyniki są buforowane według zapytania przez 15 minut (można to skonfigurować).

OpenClaw zawiera też x_search dla wpisów z X (dawniej Twitter) oraz web_fetch do lekkiego pobierania URL-i. W tej fazie web_fetch pozostaje lokalne, a web_search i x_search mogą używać xAI Responses pod spodem.

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

Natywne wyszukiwanie internetowe OpenAI

Bezpośrednie modele OpenAI Responses automatycznie używają hostowanego przez OpenAI narzędzia web_search, gdy wyszukiwanie internetowe OpenClaw jest włączone i nie przypięto żadnego zarządzanego dostawcy. Jest to zachowanie należące do dostawcy w dołączonym Plugin OpenAI i dotyczy tylko natywnego ruchu OpenAI API, a nie zgodnych z OpenAI bazowych URL-i proxy 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 zarządzane wyszukiwanie, jak i natywne wyszukiwanie OpenAI.

Natywne wyszukiwanie internetowe Codex

Modele obsługujące Codex mogą opcjonalnie używać natywnego dla dostawcy narzędzia Responses web_search zamiast zarządzanej funkcji OpenClaw web_search.

• Skonfiguruj je pod tools.web.search.openaiCodex
• Aktywuje się tylko dla modeli obsługujących Codex (openai-codex/* lub dostawców używających api: "openai-codex-responses")
• Zarządzane web_search nadal dotyczy modeli innych niż Codex
• mode: "cached" jest ustawieniem domyślnym i zalecanym
• tools.web.search.enabled: false wyłącza zarówno zarządzane, jak i natywne wyszukiwanie

{  tools: {    web: {      search: {        enabled: true,        openaiCodex: {          enabled: true,          mode: "cached",          allowedDomains: ["example.com"],          contextSize: "high",          userLocation: {            country: "US",            city: "New York",            timezone: "America/New_York",          },        },      },    },  },}

Jeśli natywne wyszukiwanie Codex jest włączone, ale bieżący model nie obsługuje Codex, OpenClaw zachowuje normalne zarządzane zachowanie web_search.

Bezpieczeństwo sieci

Zarządzane wywołania dostawcy web_search używają chronionej ścieżki pobierania OpenClaw. Dla zaufanych hostów API dostawców OpenClaw zezwala na odpowiedzi DNS fake-IP Surge, Clash i sing-box w 198.18.0.0/15 oraz fc00::/7 tylko dla tej nazwy hosta dostawcy. Inne prywatne, loopback, link-local i metadane docelowe pozostają zablokowane.

To automatyczne zezwolenie nie dotyczy dowolnych URL-i web_fetch. Dla web_fetch włącz tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange i tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange jawnie tylko wtedy, gdy zaufane proxy jest właścicielem tych syntetycznych zakresów.

Konfigurowanie wyszukiwania internetowego

Listy dostawców w dokumentacji i przepływach konfiguracji są alfabetyczne. Automatyczne wykrywanie utrzymuje oddzielną kolejność pierwszeństwa.

Jeśli nie ustawiono provider, OpenClaw sprawdza dostawców w tej kolejności i używa pierwszego gotowego:

Najpierw dostawcy oparci na 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 -- 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 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)

Następnie awaryjne opcje bez klucza:

10. DuckDuckGo -- awaryjna opcja HTML bez klucza, bez konta ani klucza API (kolejność 100)
11. Ollama Web Search -- awaryjna opcja bez klucza przez skonfigurowanego lokalnego hosta Ollama, gdy jest osiągalny i zalogowany przez ollama signin; może ponownie używać uwierzytelniania bearer dostawcy Ollama, gdy host go potrzebuje, i może wywoływać bezpośrednie wyszukiwanie https://ollama.com, gdy skonfigurowano OLLAMA_API_KEY (kolejność 110)
12. SearXNG -- SEARXNG_BASE_URL lub plugins.entries.searxng.config.webSearch.baseUrl (kolejność 200)

Jeśli nie wykryto żadnego dostawcy, nastąpi powrót do Brave (otrzymasz błąd brakującego klucza z prośbą o skonfigurowanie go).

Konfiguracja

{  tools: {    web: {      search: {        enabled: true, // default: true        provider: "brave", // or omit for auto-detection        maxResults: 5,        timeoutSeconds: 30,        cacheTtlMinutes: 15,      },    },  },}

Konfiguracja specyficzna dla dostawcy (klucze API, bazowe adresy URL, tryby) znajduje się pod plugins.entries.<plugin>.config.webSearch.*. Gemini może także ponownie używać models.providers.google.apiKey oraz models.providers.google.baseUrl jako zapasowych opcji o niższym priorytecie po dedykowanej konfiguracji wyszukiwania w sieci i GEMINI_API_KEY. Przykłady znajdziesz na stronach dostawców.

tools.web.search.provider jest sprawdzane względem identyfikatorów dostawców wyszukiwania w sieci zadeklarowanych w manifestach dołączonych i zainstalowanych pluginów. Literówka taka jak "brvae" powoduje błąd walidacji konfiguracji zamiast cichego powrotu do automatycznego wykrywania. Jeśli skonfigurowany dostawca ma tylko nieaktualny dowód pluginu, na przykład pozostały blok plugins.entries.<plugin> po odinstalowaniu pluginu innej firmy, OpenClaw zachowuje odporność uruchamiania i zgłasza ostrzeżenie, aby można było ponownie zainstalować plugin albo uruchomić openclaw doctor --fix, aby wyczyścić nieaktualną konfigurację.

Wybór dostawcy zapasowego dla web_fetch jest osobny:

• wybierz go przez tools.web.fetch.provider
• albo pomiń to pole i pozwól OpenClaw automatycznie wykryć pierwszego gotowego dostawcę pobierania z sieci na podstawie dostępnych poświadczeń
• web_fetch poza piaskownicą może używać zainstalowanych dostawców pluginów deklarujących contracts.webFetchProviders; pobieranie w piaskownicy pozostaje ograniczone do dołączonych dostawców
• obecnie dołączonym dostawcą pobierania z sieci jest Firecrawl, skonfigurowany pod plugins.entries.firecrawl.config.webFetch.*

Gdy wybierzesz Kimi podczas openclaw onboard albo openclaw configure --section web, OpenClaw może także zapytać o:

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

Dla x_search skonfiguruj plugins.entries.xai.config.xSearch.*. Używa tego samego profilu uwierzytelniania xAI co czat albo XAI_API_KEY / poświadczenia wyszukiwania w sieci pluginu używanego przez wyszukiwanie w sieci Grok. Starsza konfiguracja tools.web.x_search.* jest automatycznie migrowana przez openclaw doctor --fix. Gdy wybierzesz Grok podczas openclaw onboard albo openclaw configure --section web, OpenClaw może także zaproponować opcjonalną konfigurację x_search z tym samym kluczem. To osobny kolejny krok w ścieżce Grok, a nie osobny wybór dostawcy wyszukiwania w sieci na najwyższym poziomie. Jeśli wybierzesz innego dostawcę, OpenClaw nie pokaże 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 odpytuje wpisy X (dawniej Twitter) przy użyciu xAI i zwraca odpowiedzi syntetyzowane przez AI z cytowaniami. Akceptuje zapytania w języku naturalnym oraz opcjonalne filtry strukturalne. OpenClaw włącza wbudowane narzędzie xAI x_search tylko dla żądania obsługującego to wywołanie narzędzia.

Konfiguracja x_search

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true,            model: "grok-4-1-fast-non-reasoning",            baseUrl: "https://api.x.ai/v1", // optional, overrides webSearch.baseUrl            inlineCitations: false,            maxTurns: 2,            timeoutSeconds: 30,            cacheTtlMinutes: 15,          },          webSearch: {            apiKey: "xai-...", // optional if an xAI auth profile or XAI_API_KEY is set            baseUrl: "https://api.x.ai/v1", // optional shared xAI Responses base URL          },        },      },    },  },}

x_search wysyła wpisy do <baseUrl>/responses, gdy plugins.entries.xai.config.xSearch.baseUrl jest ustawione. Jeśli to pole zostanie pominięte, następuje powrót do plugins.entries.xai.config.webSearch.baseUrl, następnie do starszego tools.web.search.grok.baseUrl, a na końcu do publicznego punktu końcowego xAI.

Parametry x_search

Przykład x_search

await x_search({  query: "dinner recipes",  allowed_x_handles: ["nytfood"],  from_date: "2026-03-01",});

// Per-post stats: use the exact status URL or status ID when possibleawait x_search({  query: "https://x.com/huntharo/status/1905678901234567890",});

Przykłady

// Basic searchawait web_search({ query: "OpenClaw plugin SDK" }); // German-specific searchawait web_search({ query: "TV online schauen", country: "DE", language: "de" }); // Recent results (past week)await web_search({ query: "AI developments", freshness: "week" }); // Date rangeawait web_search({  query: "climate research",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Domain filtering (Perplexity only)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],});

Profile narzędzi

Jeśli używasz profili narzędzi albo list dozwolonych, dodaj web_search, x_search albo group:web:

{  tools: {    allow: ["web_search", "x_search"],    // or: allow: ["group:web"]  (includes web_search, x_search, and web_fetch)  },}

Powiązane

• Web Fetch -- pobierz adres URL i wyodrębnij czytelną treść
• Web Browser -- pełna automatyzacja przeglądarki dla witryn mocno opartych na JS
• Grok Search -- Grok jako dostawca web_search
• Ollama Web Search -- wyszukiwanie w sieci bez klucza przez host Ollama