Tools

Tavily

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

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

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

गुण	मान
Plugin आईडी	`tavily`
पैकेज	`@openclaw/tavily-plugin`
प्रमाणीकरण	`TAVILY_API_KEY` या config `apiKey`
आधार URL	`https://api.tavily.com` (डिफ़ॉल्ट)
टूल	`tavily_search`, `tavily_extract`

शुरू करना

Install the plugin

bash

openclaw plugins install @openclaw/tavily-plugin

Get an API key

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

Configure the plugin and provider

json5

{  plugins: {    entries: {      tavily: {        enabled: true,        config: {          webSearch: {            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set            baseUrl: "https://api.tavily.com",          },        },      },    },  },  tools: {    web: {      search: {        provider: "tavily",      },    },  },}

Verify search runs

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

टूल संदर्भ

`tavily_search`

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

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

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

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

`tavily_extract`

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

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

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

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

सही टूल चुनना

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

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

API key resolution order

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

plugins.entries.tavily.config.webSearch.apiKey (SecretRefs के माध्यम से हल किया गया)।
Gateway परिवेश से TAVILY_API_KEY।

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

Custom base URL

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

`chunks_per_source` requires `query`

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