वेब खोज

web_search आपके कॉन्फ़िगर किए गए प्रदाता से वेब पर खोज करता है और सामान्यीकृत परिणाम लौटाता है, जिन्हें क्वेरी के आधार पर 15 मिनट के लिए कैश किया जाता है (कॉन्फ़िगर करने योग्य)। OpenClaw X (पूर्व में Twitter) पोस्ट के लिए x_search और हल्के URL फ़ेचिंग के लिए web_fetch भी बंडल करता है। web_fetch हमेशा स्थानीय रूप से चलता है; जब Grok प्रदाता होता है, तो web_search xAI Responses के माध्यम से रूट करता है, और x_search हमेशा xAI Responses का उपयोग करता है।

त्वरित शुरुआत

openclaw configure --section web

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

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

प्रदाता चुनना

प्रदाता तुलना

परिणाम का स्वरूप

web_search कोर टूल सीमा पर प्रत्येक बंडल और बाहरी Plugin प्रदाता को सामान्यीकृत करता है। कॉलर को इनमें से ठीक एक बंद स्वरूप मिलता है:

type WebSearchOutput =  | {      kind: "error";      provider: string;      error: "provider_error";      message: string;      docs?: string;    }  | {      kind: "results";      provider: string;      query: string;      count: number;      tookMs?: number;      results: Array<{        title: string;        url: string;        snippet?: string;        published?: string;        siteName?: string;      }>;      externalContent: {        untrusted: true;        source: "web_search";        wrapped: true;        provider: string;      };      cached?: true;    }  | {      kind: "answer";      provider: string;      query: string;      tookMs?: number;      content: string;      citations?: Array<{ url: string; title?: string }>;      externalContent: {        untrusted: true;        source: "web_search";        wrapped: true;        provider: string;      };      cached?: true;    }  | {      kind: "raw";      provider: string;      data: unknown;    };

संरचित प्रदाता kind: "results" का उपयोग करते हैं; संश्लेषित प्रदाता kind: "answer" का उपयोग करते हैं। जिन बाहरी Plugin प्रदाताओं के पेलोड किसी भी स्वरूप से मेल नहीं खाते, वे संगतता के लिए kind: "raw" के रूप में ज्यों के त्यों पारित होते हैं। कच्चे स्कोर, अंश, संबंधित खोजें, इनलाइन-उद्धरण ऑफ़सेट, मॉडल आईडी या सत्र मेटाडेटा जैसे प्रदाता-विशिष्ट फ़ील्ड सामान्यीकृत शाखाओं में पारित नहीं किए जाते। जब किसी प्रदाता की अधिक समृद्ध प्रतिक्रिया आपके कार्यप्रवाह का हिस्सा हो, तो उसके समर्पित टूल का उपयोग करें।

externalContent.wrapped: true एक विश्वास चिह्नक है जिसे सीमा स्वयं सत्य बनाती है: प्रदाता का गद्य (title, snippet, siteName, content, उद्धरण शीर्षक, त्रुटि message) से पहले से मौजूद सभी एनवेलप पंक्तियाँ हटा दी जाती हैं और कोर सीमा पर ठीक एक बार फिर से लपेटा जाता है, इसलिए कोई प्रदाता मेटाडेटा इस चिह्नक की नकल नहीं कर सकता। query हमेशा अनुरोधित क्वेरी होती है, उद्धरण और परिणाम URL http(s) के रूप में पार्स होने चाहिए, published ISO-तिथि स्वरूप में होना चाहिए, URL कैनोनिकल रूप में उत्सर्जित किए जाते हैं, और error कुंजी वाला पेलोड हमेशा kind: "error" के रूप में रिपोर्ट किया जाता है, जबकि कच्चा प्रदाता कोड लपेटे गए संदेश के भीतर सुरक्षित रखा जाता है। कच्चे ज्यों-के-त्यों पारित पेलोड प्रदाता द्वारा सेट किए गए सभी चिह्नक बनाए रखते हैं।

स्वतः पहचान

दस्तावेज़ों और सेटअप प्रवाहों में प्रदाता सूचियाँ वर्णानुक्रम में होती हैं। स्वतः पहचान एक अलग, निश्चित वरीयता क्रम का उपयोग करती है और क्रेडेंशियल की आवश्यकता वाले प्रदाता (requiresCredential !== false) को तभी चुनती है, जब वह उसे कॉन्फ़िगर किया हुआ पाती है। यदि कोई provider सेट नहीं है, तो OpenClaw इस क्रम में प्रदाताओं की जाँच करता है और तैयार पहले प्रदाता का उपयोग करता है:

पहले API-समर्थित प्रदाता:

1. Brave -- BRAVE_API_KEY या plugins.entries.brave.config.webSearch.apiKey (क्रम 10)
2. MiniMax Search -- MINIMAX_CODE_PLAN_KEY / MINIMAX_CODING_API_KEY / MINIMAX_OAUTH_TOKEN / MINIMAX_API_KEY या plugins.entries.minimax.config.webSearch.apiKey (क्रम 15)
3. Gemini -- plugins.entries.google.config.webSearch.apiKey, GEMINI_API_KEY, या models.providers.google.apiKey (क्रम 20)
4. Grok -- xAI OAuth, XAI_API_KEY, या plugins.entries.xai.config.webSearch.apiKey (क्रम 30)
5. Kimi -- KIMI_API_KEY / MOONSHOT_API_KEY या plugins.entries.moonshot.config.webSearch.apiKey (क्रम 40)
6. Perplexity -- PERPLEXITY_API_KEY / OPENROUTER_API_KEY या plugins.entries.perplexity.config.webSearch.apiKey (क्रम 50)
7. Firecrawl -- FIRECRAWL_API_KEY या plugins.entries.firecrawl.config.webSearch.apiKey (क्रम 60)
8. Exa -- EXA_API_KEY या plugins.entries.exa.config.webSearch.apiKey; वैकल्पिक plugins.entries.exa.config.webSearch.baseUrl Exa एंडपॉइंट को ओवरराइड करता है (क्रम 65)
9. Tavily -- TAVILY_API_KEY या plugins.entries.tavily.config.webSearch.apiKey (क्रम 70)
10. Parallel -- PARALLEL_API_KEY या plugins.entries.parallel.config.webSearch.apiKey के माध्यम से सशुल्क Parallel Search API; वैकल्पिक plugins.entries.parallel.config.webSearch.baseUrl एंडपॉइंट को ओवरराइड करता है (क्रम 75)

उसके बाद कॉन्फ़िगर किए गए एंडपॉइंट प्रदाता:

11. SearXNG -- SEARXNG_BASE_URL या plugins.entries.searxng.config.webSearch.baseUrl (क्रम 200)

Parallel Search (Free), DuckDuckGo, Ollama Web Search, और Codex Hosted Search जैसे कुंजी-मुक्त प्रदाता कभी भी स्वतः-पहचान में नहीं चुने जाते, भले ही उनका कोई आंतरिक क्रम मान हो। उनका उपयोग केवल तभी किया जाता है, जब आप उन्हें tools.web.search.provider से स्पष्ट रूप से या openclaw configure --section web के माध्यम से चुनते हैं। केवल इसलिए कि कोई API-समर्थित प्रदाता कॉन्फ़िगर नहीं है, OpenClaw प्रबंधित web_search क्वेरी किसी कुंजी-मुक्त प्रदाता को नहीं भेजता।

OpenAI Responses मॉडल अपवाद हैं: जब tools.web.search.provider सेट नहीं होता, तो वे ऊपर दिए गए प्रबंधित प्रदाताओं के बजाय OpenAI की मूल वेब खोज का उपयोग करते हैं (नीचे देखें)। उन्हें इसके बजाय प्रबंधित पथ से रूट करने के लिए tools.web.search.provider को parallel-free (या किसी अन्य प्रदाता) पर सेट करें।

मूल OpenAI वेब खोज

प्रत्यक्ष OpenAI Responses मॉडल (api: "openai-responses", प्रदाता openai, कोई बेस URL नहीं या आधिकारिक OpenAI API बेस URL) OpenClaw वेब खोज सक्षम होने और कोई प्रबंधित प्रदाता पिन न होने पर OpenAI के होस्ट किए गए web_search टूल का स्वतः उपयोग करते हैं। यह बंडल किए गए OpenAI Plugin में प्रदाता-स्वामित्व वाला व्यवहार है और OpenAI-संगत प्रॉक्सी बेस URL या Azure रूट पर लागू नहीं होता। OpenAI मॉडल के लिए प्रबंधित web_search टूल बनाए रखने हेतु tools.web.search.provider को brave जैसे किसी अन्य प्रदाता पर सेट करें, या प्रबंधित खोज और मूल OpenAI खोज दोनों अक्षम करने हेतु tools.web.search.enabled: false सेट करें।

मूल Codex वेब खोज

वेब खोज सक्षम होने और कोई प्रबंधित प्रदाता न चुने जाने पर Codex ऐप-सर्वर रनटाइम, Codex के होस्ट किए गए web_search टूल का स्वतः उपयोग करता है। मूल होस्ट की गई खोज और OpenClaw का प्रबंधित web_search डायनेमिक टूल परस्पर अनन्य हैं, इसलिए प्रबंधित खोज मूल डोमेन प्रतिबंधों को बायपास नहीं कर सकती। होस्ट की गई खोज अनुपलब्ध होने, स्पष्ट रूप से अक्षम होने, या किसी चुने गए प्रबंधित प्रदाता से प्रतिस्थापित होने पर OpenClaw प्रबंधित टूल का उपयोग करता है। OpenClaw, Codex के स्टैंडअलोन web.run एक्सटेंशन को अक्षम (features.standalone_web_search: false) रखता है, क्योंकि प्रोडक्शन ऐप-सर्वर ट्रैफ़िक उसके उपयोगकर्ता-परिभाषित web नेमस्पेस को अस्वीकार करता है।

• tools.web.search.openaiCodex के अंतर्गत मूल खोज कॉन्फ़िगर करें
• किसी भी पैरेंट मॉडल के लिए Codex Hosted Search को प्रबंधित web_search प्रदाता के रूप में प्रावधान करने हेतु tools.web.search.provider: "codex" सेट करें। प्रत्येक कॉल एक सीमित अस्थायी Codex ऐप-सर्वर टर्न चलाती है और यदि Codex कोई होस्ट किया गया webSearch आइटम उत्सर्जित नहीं करता, तो विफल हो जाती है।
• mode: "cached" डिफ़ॉल्ट प्राथमिकता है, लेकिन अप्रतिबंधित ऐप-सर्वर टर्न के लिए Codex इसे लाइव बाहरी एक्सेस में रिज़ॉल्व करता है; लाइव एक्सेस का स्पष्ट रूप से अनुरोध करने हेतु "live" सेट करें
• OpenClaw के प्रबंधित web_search का उपयोग करने हेतु tools.web.search.provider को brave जैसे किसी प्रबंधित प्रदाता पर सेट करें
• Codex द्वारा होस्ट की गई खोज से बाहर रहने हेतु tools.web.search.openaiCodex.enabled: false सेट करें; अन्य प्रबंधित प्रदाता उपलब्ध रहते हैं
• Codex की मूल टूल सतह को प्रतिबंधित करने पर भी प्रबंधित web_search उपलब्ध रहता है
• जब allowedDomains सेट होता है, तो होस्ट की गई खोज अनुपलब्ध होने पर स्वचालित प्रबंधित फ़ॉलबैक बंद स्थिति में विफल होता है, ताकि मूल अनुमति-सूची को बायपास न किया जा सके
• टूल-अक्षम केवल-LLM रन मूल और प्रबंधित दोनों खोज अक्षम करते हैं
• tools.web.search.enabled: false प्रबंधित और मूल दोनों खोज अक्षम करता है

स्थायी प्रभावी Codex खोज-नीति परिवर्तन एक नया बाउंड थ्रेड शुरू करते हैं, ताकि पहले से लोड किया गया ऐप-सर्वर थ्रेड पुरानी होस्टेड-खोज एक्सेस बनाए न रख सके। क्षणिक प्रति-टर्न प्रतिबंध एक अस्थायी प्रतिबंधित थ्रेड का उपयोग करते हैं और बाद में फिर से शुरू करने के लिए मौजूदा बाइंडिंग सुरक्षित रखते हैं।

प्रत्यक्ष OpenAI ChatGPT Responses ट्रैफ़िक भी OpenAI के होस्ट किए गए web_search टूल का उपयोग कर सकता है। वह अलग पथ tools.web.search.openaiCodex.enabled: true के माध्यम से वैकल्पिक रहता है और केवल api: "openai-chatgpt-responses" का उपयोग करने वाले पात्र openai/* मॉडल पर लागू होता है।

{  tools: {    web: {      search: {        enabled: true,        // वैकल्पिक: गैर-Codex पैरेंट मॉडल से भी Codex Hosted Search का उपयोग करें।        provider: "codex",        openaiCodex: {          enabled: true,          mode: "cached",          allowedDomains: ["example.com"],          contextSize: "high",          userLocation: {            country: "US",            city: "New York",            timezone: "America/New_York",          },        },      },    },  },}

जो रनटाइम और प्रदाता मूल Codex खोज का समर्थन नहीं करते, उनके लिए Codex, OpenClaw के डायनेमिक टूल नेमस्पेस के माध्यम से प्रबंधित web_search फ़ॉलबैक का उपयोग कर सकता है। जब आपको Codex द्वारा होस्ट की गई खोज के बजाय OpenClaw के प्रदाता-विशिष्ट नेटवर्क नियंत्रणों की आवश्यकता हो, तो स्पष्ट रूप से किसी प्रबंधित प्रदाता का उपयोग करें।

provider: "codex" चुनने पर बंडल किया गया codex Plugin सक्षम होता है और ऊपर दिखाए गए समान tools.web.search.openaiCodex प्रतिबंधों का उपयोग होता है। पहले openclaw models auth login --provider openai से Codex ऐप-सर्वर को प्रमाणित करें। पैरेंट एजेंट किसी भी मॉडल या रनटाइम का उपयोग कर सकता है; केवल सीमित खोज वर्कर Codex के माध्यम से चलता है।

नेटवर्क सुरक्षा

प्रबंधित HTTP web_search प्रदाता कॉल OpenClaw के सुरक्षित फ़ेच पथ का उपयोग करती हैं, जिसका दायरा वर्तमान प्रदाता के अपने होस्टनाम तक सीमित होता है। केवल उस होस्टनाम के लिए, OpenClaw 198.18.0.0/15 और fc00::/7 में Surge, Clash, और sing-box के नकली-IP DNS उत्तरों की अनुमति देता है। अन्य निजी, लूपबैक, लिंक-लोकल, और मेटाडेटा गंतव्य अवरुद्ध रहते हैं। Codex Hosted Search इसका अपवाद है: इसका सीमित वर्कर नेटवर्क एक्सेस को Codex ऐप-सर्वर के होस्ट किए गए web_search टूल को सौंपता है।

यह स्वचालित अनुमति मनमाने web_fetch URL पर लागू नहीं होती। web_fetch के लिए, tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange और tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange को स्पष्ट रूप से केवल तभी सक्षम करें, जब आपका विश्वसनीय प्रॉक्सी उन कृत्रिम रेंज का स्वामी हो।

कॉन्फ़िगरेशन

{  tools: {    web: {      search: {        enabled: true, // डिफ़ॉल्ट: true        provider: "brave", // या स्वतः-पहचान के लिए इसे छोड़ दें        maxResults: 5,        timeoutSeconds: 30,        cacheTtlMinutes: 15,      },    },  },}

प्रदाता-विशिष्ट कॉन्फ़िगरेशन (API कुंजियाँ, बेस URL, मोड) plugins.entries.<plugin>.config.webSearch.* के अंतर्गत रहता है। Gemini अपने समर्पित वेब-खोज कॉन्फ़िगरेशन और GEMINI_API_KEY के बाद कम-प्राथमिकता वाले फ़ॉलबैक के रूप में models.providers.google.apiKey और models.providers.google.baseUrl का भी पुनः उपयोग कर सकता है। उदाहरणों के लिए प्रदाता पृष्ठ देखें। Grok, openclaw models auth login --provider xai --method oauth से xAI OAuth प्रमाणीकरण प्रोफ़ाइल का भी पुनः उपयोग कर सकता है; API-कुंजी कॉन्फ़िगरेशन फ़ॉलबैक रहता है।

tools.web.search.provider को बंडल और इंस्टॉल किए गए Plugin मैनिफ़ेस्ट द्वारा घोषित वेब-खोज प्रदाता ID के विरुद्ध सत्यापित किया जाता है। "brvae" जैसी टाइपिंग त्रुटि चुपचाप स्वतः-पहचान पर वापस जाने के बजाय कॉन्फ़िगरेशन सत्यापन विफल कर देती है। यदि किसी कॉन्फ़िगर किए गए प्रदाता के पास केवल पुराना Plugin प्रमाण हो, जैसे किसी तृतीय-पक्ष Plugin को अनइंस्टॉल करने के बाद बचा हुआ plugins.entries.<plugin> ब्लॉक, तो OpenClaw स्टार्टअप को लचीला बनाए रखता है और चेतावनी देता है, ताकि आप Plugin को फिर से इंस्टॉल कर सकें या पुराने कॉन्फ़िगरेशन को साफ़ करने के लिए openclaw doctor --fix चला सकें।

web_fetch फ़ॉलबैक प्रदाता चयन अलग है:

• इसे tools.web.fetch.provider से चुनें
• या उस फ़ील्ड को छोड़ दें और OpenClaw को कॉन्फ़िगर किए गए क्रेडेंशियल से पहला तैयार वेब-फ़ेच प्रदाता स्वतः पहचानने दें
• गैर-सैंडबॉक्स web_fetch, ऐसे इंस्टॉल किए गए Plugin प्रदाताओं का उपयोग कर सकता है जो contracts.webFetchProviders घोषित करते हैं; सैंडबॉक्स फ़ेच बंडल प्रदाताओं और सत्यापित आधिकारिक Plugin इंस्टॉल की अनुमति देते हैं, लेकिन तृतीय-पक्ष बाहरी Plugin को शामिल नहीं करते
• आधिकारिक Firecrawl Plugin आज एकमात्र बंडल किया गया webFetchProviders योगदानकर्ता है, जिसे plugins.entries.firecrawl.config.webFetch.* के अंतर्गत कॉन्फ़िगर किया जाता है

openclaw onboard या openclaw configure --section web के दौरान Kimi चुनने पर, OpenClaw यह भी पूछ सकता है:

• Moonshot API क्षेत्र (https://api.moonshot.ai/v1 या https://api.moonshot.cn/v1)
• डिफ़ॉल्ट Kimi वेब-खोज मॉडल (डिफ़ॉल्ट kimi-k2.6)

x_search के लिए, plugins.entries.xai.config.xSearch.* कॉन्फ़िगर करें। यह चैट वाली समान xAI प्रमाणीकरण प्रोफ़ाइल या Grok वेब खोज द्वारा उपयोग किए जाने वाले XAI_API_KEY / Plugin वेब-खोज क्रेडेंशियल का उपयोग करता है। पुराना tools.web.x_search.* कॉन्फ़िगरेशन openclaw doctor --fix द्वारा स्वतः माइग्रेट किया जाता है। openclaw onboard या openclaw configure --section web के दौरान Grok चुनने पर, Grok सेटअप पूरा होने के तुरंत बाद OpenClaw उसी क्रेडेंशियल के साथ वैकल्पिक x_search सेटअप भी प्रस्तुत करता है। यह Grok पथ के भीतर एक अलग अनुवर्ती चरण है, कोई अलग शीर्ष-स्तरीय वेब-खोज प्रदाता विकल्प नहीं। यदि आप कोई अन्य प्रदाता चुनते हैं, तो OpenClaw x_search प्रॉम्प्ट नहीं दिखाता।

API कुंजियाँ संग्रहीत करना

{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "YOUR_KEY", // pragma: अनुमति-सूची सीक्रेट          },        },      },    },  },}

export BRAVE_API_KEY="YOUR_KEY"

टूल पैरामीटर

x_search

x_search, xAI का उपयोग करके X (पूर्व में Twitter) पोस्ट की क्वेरी करता है और उद्धरणों सहित AI-संश्लेषित उत्तर लौटाता है। यह स्वाभाविक भाषा की क्वेरी और वैकल्पिक संरचित फ़िल्टर स्वीकार करता है। OpenClaw, अंतर्निहित xAI x_search टूल को स्थायी रूप से पंजीकृत रखने के बजाय हर अनुरोध के लिए बनाता है, इसलिए यह केवल उसी टर्न में सक्रिय होता है जिसमें वास्तव में इसे कॉल किया जाता है।

x_search कॉन्फ़िगरेशन

enabled को छोड़ने पर, x_search केवल तभी उपलब्ध कराया जाता है जब सक्रिय मॉडल का प्रदाता xai हो और xAI क्रेडेंशियल उपलब्ध हों। ज्ञात गैर-xAI प्रदाता वाले सक्रिय मॉडल के लिए, क्रॉस-प्रदाता उपयोग चुनने हेतु plugins.entries.xai.config.xSearch.enabled को true पर सेट करें। यदि सक्रिय मॉडल प्रदाता अनुपस्थित हो या उसका समाधान न हुआ हो, तो टूल छिपा रहता है। इसे हर प्रदाता के लिए अक्षम करने हेतु enabled को false पर सेट करें। xAI क्रेडेंशियल हमेशा आवश्यक होते हैं।

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true, // किसी ज्ञात गैर-xAI मॉडल प्रदाता के लिए आवश्यक            model: "grok-4.3",            baseUrl: "https://api.x.ai/v1", // वैकल्पिक, webSearch.baseUrl को ओवरराइड करता है            inlineCitations: false,            maxTurns: 2,            timeoutSeconds: 30,            cacheTtlMinutes: 15,          },          webSearch: {            apiKey: "xai-...", // यदि कोई xAI प्रमाणीकरण प्रोफ़ाइल या XAI_API_KEY सेट है, तो वैकल्पिक            baseUrl: "https://api.x.ai/v1", // वैकल्पिक साझा xAI Responses आधार URL          },        },      },    },  },}

plugins.entries.xai.config.xSearch.baseUrl सेट होने पर x_search, <baseUrl>/responses पर पोस्ट करता है। यदि यह फ़ील्ड छोड़ा गया हो, तो यह पहले plugins.entries.xai.config.webSearch.baseUrl, फिर सार्वजनिक xAI एंडपॉइंट (https://api.x.ai/v1) का उपयोग करता है।

x_search पैरामीटर

allowed_x_handles और excluded_x_handles परस्पर अपवर्जी हैं।

x_search उदाहरण

await x_search({  query: "रात्रिभोज की रेसिपी",  allowed_x_handles: ["nytfood"],  from_date: "2026-03-01",});

// प्रति-पोस्ट आँकड़े: संभव होने पर सटीक स्थिति URL या स्थिति ID का उपयोग करेंawait x_search({  query: "https://x.com/huntharo/status/1905678901234567890",});

उदाहरण

// बुनियादी खोजawait web_search({ query: "OpenClaw plugin SDK" }); // जर्मनी-विशिष्ट खोजawait web_search({ query: "TV online schauen", country: "DE", language: "de" }); // हाल के परिणाम (पिछला सप्ताह)await web_search({ query: "AI developments", freshness: "week" }); // तारीख की सीमाawait web_search({  query: "climate research",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // डोमेन फ़िल्टरिंग (केवल Perplexity)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],});

टूल प्रोफ़ाइल

यदि आप टूल प्रोफ़ाइल या अनुमति-सूचियों का उपयोग करते हैं, तो web_search, x_search, या group:web जोड़ें:

{  tools: {    allow: ["web_search", "x_search"],    // या: allow: ["group:web"]  (इसमें web_search, x_search और web_fetch शामिल हैं)  },}

संबंधित

• वेब फ़ेच -- किसी URL को प्राप्त करें और पठनीय सामग्री निकालें
• वेब ब्राउज़र -- JS-प्रधान साइटों के लिए पूर्ण ब्राउज़र स्वचालन
• Grok खोज -- web_search प्रदाता के रूप में Grok
• Ollama वेब खोज -- आपके Ollama होस्ट के माध्यम से कुंजी-रहित वेब खोज