Tools

Tavily

Tavily AI अनुप्रयोगों के लिए डिज़ाइन किया गया एक खोज API है। OpenClaw इसे दो तरीकों से उपलब्ध कराता है:

सामान्य खोज टूल के लिए web_search प्रदाता के रूप में
स्पष्ट Plugin टूल के रूप में: tavily_search और tavily_extract

Tavily LLM के उपयोग के लिए अनुकूलित संरचित परिणाम देता है, जिनमें कॉन्फ़िगर करने योग्य खोज गहराई, विषय फ़िल्टरिंग, डोमेन फ़िल्टर, AI-जनित उत्तर सारांश और URL से सामग्री निष्कर्षण (JavaScript द्वारा रेंडर किए गए पृष्ठों सहित) शामिल हैं।

गुण	मान
Plugin आईडी	`tavily`
पैकेज	`@openclaw/tavily-plugin`
प्रमाणीकरण	`TAVILY_API_KEY` एनवायरनमेंट वेरिएबल या कॉन्फ़िग `apiKey`
आधार URL	`https://api.tavily.com` (डिफ़ॉल्ट); ओवरराइड करने के लिए `TAVILY_BASE_URL` एनवायरनमेंट वेरिएबल या कॉन्फ़िग `baseUrl`
टाइमआउट	खोज के लिए 30s, निष्कर्षण के लिए 60s (डिफ़ॉल्ट)
टूल	`tavily_search`, `tavily_extract`

आरंभ करना

Plugin इंस्टॉल करें

bash

openclaw plugins install @openclaw/tavily-plugin

API कुंजी प्राप्त करें

tavily.com पर Tavily खाता बनाएँ, फिर डैशबोर्ड में एक API कुंजी जनरेट करें।

Plugin और प्रदाता कॉन्फ़िगर करें

json5

{  plugins: {    entries: {      tavily: {        enabled: true,        config: {          webSearch: {            apiKey: "tvly-...", // यदि TAVILY_API_KEY सेट है, तो वैकल्पिक            baseUrl: "https://api.tavily.com",          },        },      },    },  },  tools: {    web: {      search: {        provider: "tavily",      },    },  },}

सत्यापित करें कि खोज चलती है

किसी भी एजेंट से web_search ट्रिगर करें या सीधे tavily_search को कॉल करें।

टूल संदर्भ

`tavily_search`

जब सामान्य web_search के बजाय Tavily-विशिष्ट खोज नियंत्रण चाहिए हों, तो इसका उपयोग करें।

पैरामीटर	प्रकार	बाधाएँ / डिफ़ॉल्ट	विवरण
`query`	स्ट्रिंग	आवश्यक	खोज क्वेरी स्ट्रिंग।
`search_depth`	एनम	`basic` (डिफ़ॉल्ट), `advanced`	`advanced` धीमा है, लेकिन अधिक प्रासंगिक है।
`topic`	एनम	`general` (डिफ़ॉल्ट), `news`, `finance`	विषय वर्ग के अनुसार फ़िल्टर करें।
`max_results`	पूर्णांक	1-20, डिफ़ॉल्ट `5`	परिणामों की संख्या।
`include_answer`	बूलियन	डिफ़ॉल्ट `false`	Tavily का AI-जनित उत्तर सारांश शामिल करें।
`time_range`	एनम	`day`, `week`, `month`, `year`	नवीनता के अनुसार परिणाम फ़िल्टर करें।
`include_domains`	स्ट्रिंग ऐरे	(कोई नहीं)	केवल इन डोमेन के परिणाम शामिल करें।
`exclude_domains`	स्ट्रिंग ऐरे	(कोई नहीं)	इन डोमेन के परिणाम बाहर रखें।

खोज गहराई का संतुलन:

गहराई	गति	प्रासंगिकता	इनके लिए सर्वोत्तम
`basic`	अधिक तेज़	उच्च	सामान्य प्रयोजन की क्वेरी (डिफ़ॉल्ट)।
`advanced`	धीमा	उच्चतम	सटीक शोध और तथ्य-अन्वेषण।

`tavily_extract`

एक या अधिक URL से स्वच्छ सामग्री निकालने के लिए इसका उपयोग करें। यह JavaScript द्वारा रेंडर किए गए पृष्ठों को संभालता है और लक्षित निष्कर्षण के लिए क्वेरी-केंद्रित खंडन का समर्थन करता है।

पैरामीटर	प्रकार	बाधाएँ / डिफ़ॉल्ट	विवरण
`urls`	स्ट्रिंग ऐरे	आवश्यक, 1-20	वे URL जिनसे सामग्री निकालनी है।
`query`	स्ट्रिंग	(वैकल्पिक)	इस क्वेरी की प्रासंगिकता के आधार पर निकाले गए खंडों को फिर से क्रमबद्ध करें।
`extract_depth`	एनम	`basic` (डिफ़ॉल्ट), `advanced`	अधिक JS वाले पृष्ठों, SPA या डायनेमिक तालिकाओं के लिए `advanced` का उपयोग करें।
`chunks_per_source`	पूर्णांक	1-5; `query` आवश्यक है	प्रति URL लौटाए गए खंड। `query` के बिना सेट करने पर त्रुटि होती है।
`include_images`	बूलियन	डिफ़ॉल्ट `false`	परिणामों में इमेज URL शामिल करें।

निष्कर्षण गहराई का संतुलन:

गहराई	कब उपयोग करें
`basic`	सरल पृष्ठ। पहले इसे आज़माएँ।
`advanced`	JS द्वारा रेंडर किए गए SPA, डायनेमिक सामग्री, तालिकाएँ।

सही टूल चुनना

आवश्यकता	टूल
त्वरित वेब खोज, कोई विशेष विकल्प नहीं	`web_search`
गहराई, विषय और AI उत्तरों के साथ खोज	`tavily_search`
विशिष्ट URL से सामग्री निकालना	`tavily_extract`

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

API कुंजी समाधान क्रम

Tavily क्लाइंट अपनी API कुंजी इस क्रम में खोजता है:

plugins.entries.tavily.config.webSearch.apiKey (SecretRefs के माध्यम से समाधान किया गया)।
Gateway एनवायरनमेंट से TAVILY_API_KEY।

यदि इनमें से कोई भी मौजूद नहीं है, तो tavily_search और tavily_extract दोनों सेटअप त्रुटि उत्पन्न करते हैं।

कस्टम आधार URL

यदि Tavily को प्रॉक्सी के माध्यम से उपलब्ध कराया जाता है, तो plugins.entries.tavily.config.webSearch.baseUrl को ओवरराइड करें या TAVILY_BASE_URL सेट करें। कॉन्फ़िग को एनवायरनमेंट वेरिएबल पर प्राथमिकता मिलती है। डिफ़ॉल्ट https://api.tavily.com है।

`chunks_per_source` के लिए `query` आवश्यक है

tavily_extract उन कॉल को अस्वीकार करता है जो query के बिना chunks_per_source पास करती हैं। Tavily क्वेरी प्रासंगिकता के आधार पर खंडों को क्रम देता है, इसलिए इसके बिना यह पैरामीटर अर्थहीन है।