मुख्य सामग्री पर जाएं
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
आधार URLhttps://api.tavily.com (डिफ़ॉल्ट)
टूलtavily_search, tavily_extract

शुरू करना

1

Install the plugin

openclaw plugins install @openclaw/tavily-plugin
2

Get an API key

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

Configure the plugin and provider

{
  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",
      },
    },
  },
}
4

Verify search runs

किसी भी एजेंट से web_search ट्रिगर करें, या सीधे tavily_search कॉल करें।
ऑनबोर्डिंग में Tavily चुनना या openclaw configure --section web आवश्यकता होने पर आधिकारिक Tavily plugin इंस्टॉल और सक्षम करता है।

टूल संदर्भ

जब आप सामान्य web_search के बजाय Tavily-विशिष्ट खोज नियंत्रण चाहते हों, तब इसका उपयोग करें।
पैरामीटरप्रकारसीमाएं / डिफ़ॉल्टविवरण
querystringआवश्यकखोज क्वेरी string। 400 वर्णों से कम रखें।
search_depthenumbasic (डिफ़ॉल्ट), advancedadvanced धीमा है लेकिन प्रासंगिकता अधिक है।
topicenumgeneral (डिफ़ॉल्ट), news, financeविषय परिवार के अनुसार फ़िल्टर करें।
max_resultsinteger1-20परिणामों की संख्या।
include_answerbooleanडिफ़ॉल्ट falseTavily AI-जनित उत्तर सारांश शामिल करें।
time_rangeenumday, week, month, yearनवीनता के अनुसार परिणाम फ़िल्टर करें।
include_domainsstring array(कोई नहीं)केवल इन डोमेन से परिणाम शामिल करें।
exclude_domainsstring array(कोई नहीं)इन डोमेन से परिणाम बाहर रखें।
खोज गहराई का संतुलन:
गहराईगतिप्रासंगिकताइसके लिए सर्वोत्तम
basicतेज़उच्चसामान्य-उद्देश्य क्वेरी (डिफ़ॉल्ट)।
advancedधीमासर्वोच्चसटीक शोध और तथ्य-जांच।

tavily_extract

एक या अधिक URL से साफ़ सामग्री निकालने के लिए इसका उपयोग करें। यह JavaScript-रेंडर किए गए पृष्ठों को संभालता है और लक्षित निष्कर्षण के लिए क्वेरी-केंद्रित चंकिंग का समर्थन करता है।
पैरामीटरप्रकारसीमाएं / डिफ़ॉल्टविवरण
urlsstring arrayआवश्यक, 1-20जिन URL से सामग्री निकालनी है।
querystring(वैकल्पिक)निकाले गए चंक्स को इस क्वेरी से प्रासंगिकता के अनुसार फिर से रैंक करें।
extract_depthenumbasic (डिफ़ॉल्ट), advancedJS-भारी पृष्ठों, SPA, या डायनेमिक तालिकाओं के लिए advanced का उपयोग करें।
chunks_per_sourceinteger1-5; query आवश्यक हैप्रति URL लौटाए गए चंक्स। query के बिना सेट करने पर त्रुटि।
include_imagesbooleanडिफ़ॉल्ट falseपरिणामों में छवि URL शामिल करें।
निष्कर्षण गहराई का संतुलन:
गहराईकब उपयोग करें
basicसरल पृष्ठ। पहले इसे आज़माएं।
advancedJS-रेंडर किए गए SPA, डायनेमिक सामग्री, तालिकाएं।
बड़ी URL सूचियों को कई tavily_extract कॉल में बैच करें (प्रति अनुरोध अधिकतम 20)। पूर्ण पृष्ठों के बजाय केवल प्रासंगिक सामग्री पाने के लिए query के साथ chunks_per_source का उपयोग करें।

सही टूल चुनना

आवश्यकताटूल
तेज़ वेब खोज, कोई विशेष विकल्प नहींweb_search
गहराई, विषय, AI उत्तरों के साथ खोजtavily_search
विशिष्ट URL से सामग्री निकालनाtavily_extract
Tavily को प्रदाता के रूप में उपयोग करने वाला सामान्य web_search टूल query और count (20 परिणामों तक) का समर्थन करता है। Tavily-विशिष्ट नियंत्रणों (search_depth, topic, include_answer, डोमेन फ़िल्टर, समय सीमा) के लिए इसके बजाय tavily_search का उपयोग करें।

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

Tavily क्लाइंट अपनी API कुंजी इस क्रम में खोजता है:
  1. plugins.entries.tavily.config.webSearch.apiKey (SecretRefs के माध्यम से हल किया गया)।
  2. Gateway परिवेश से TAVILY_API_KEY
यदि दोनों में से कोई मौजूद नहीं है, तो tavily_extract सेटअप त्रुटि उठाता है।
यदि आप Tavily को प्रॉक्सी के माध्यम से आगे भेजते हैं, तो plugins.entries.tavily.config.webSearch.baseUrl को ओवरराइड करें। डिफ़ॉल्ट https://api.tavily.com है।
tavily_extract उन कॉल को अस्वीकार करता है जो query के बिना chunks_per_source पास करती हैं। Tavily क्वेरी प्रासंगिकता के अनुसार चंक्स को रैंक करता है, इसलिए इसके बिना यह पैरामीटर निरर्थक है।

संबंधित

Web Search overview

सभी प्रदाता और स्वतः-पहचान नियम।

Firecrawl

सामग्री निष्कर्षण के साथ खोज और स्क्रैपिंग।

Exa Search

सामग्री निष्कर्षण के साथ न्यूरल खोज।

Configuration

plugin प्रविष्टियों और टूल रूटिंग के लिए पूर्ण config स्कीमा।