الانتقال إلى المحتوى الرئيسي
Tavily هي واجهة API للبحث مصممة لتطبيقات الذكاء الاصطناعي. يتيحها OpenClaw بطريقتين:
  • بصفتها مزود web_search لأداة البحث العامة
  • بصفتها أدوات Plugin صريحة: tavily_search وtavily_extract
تعيد Tavily نتائج منظمة محسنة لاستهلاك LLM مع عمق بحث قابل للضبط، وتصفية حسب الموضوع، ومرشحات نطاقات، وملخصات إجابات مولدة بالذكاء الاصطناعي، واستخراج محتوى من عناوين URL (بما في ذلك الصفحات المعروضة بواسطة JavaScript).
الخاصيةالقيمة
معرف Plugintavily
الحزمة@openclaw/tavily-plugin
المصادقةTAVILY_API_KEY أو الإعداد apiKey
عنوان URL الأساسيhttps://api.tavily.com (افتراضي)
الأدواتtavily_search, tavily_extract

​
البدء

1

ثبّت Plugin

openclaw plugins install @openclaw/tavily-plugin
2

احصل على مفتاح API

أنشئ حساب Tavily على tavily.com، ثم أنشئ مفتاح API في لوحة التحكم.
3

اضبط Plugin والمزود

{
  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

تحقق من تشغيل البحث

شغّل web_search من أي وكيل، أو استدعِ tavily_search مباشرة.
اختيار Tavily أثناء الإعداد الأولي أو عبر openclaw configure --section web يثبّت ويمكّن Plugin الرسمي الخاص بـ Tavily عند الحاجة.

​
مرجع الأدوات

استخدم هذا عندما تريد عناصر تحكم بحث خاصة بـ Tavily بدلا من web_search العام.
المعاملالنوعالقيود / الافتراضيالوصف
querystringمطلوبسلسلة استعلام البحث. اجعلها أقل من 400 حرف.
search_depthenumbasic (افتراضي), advancedadvanced أبطأ لكنه أعلى صلة.
topicenumgeneral (افتراضي), news, financeالتصفية حسب عائلة الموضوع.
max_resultsinteger1-20عدد النتائج.
include_answerbooleanالافتراضي falseتضمين ملخص إجابة مولد بالذكاء الاصطناعي من Tavily.
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 (افتراضي), advancedاستخدم advanced للصفحات كثيرة الاعتماد على JS، أو تطبيقات SPA، أو الجداول الديناميكية.
chunks_per_sourceinteger1-5؛ يتطلب queryالمقاطع المعادة لكل عنوان URL. يسبب خطأ إذا ضُبط بدون query.
include_imagesbooleanالافتراضي falseتضمين عناوين URL للصور في النتائج.
المفاضلة في عمق الاستخراج:
العمقمتى تستخدمه
basicالصفحات البسيطة. جرّب هذا أولا.
advancedتطبيقات SPA المعروضة بواسطة JS، والمحتوى الديناميكي، والجداول.
قسّم قوائم عناوين URL الأكبر إلى عدة استدعاءات tavily_extract (بحد أقصى 20 لكل طلب). استخدم query مع chunks_per_source للحصول على المحتوى ذي الصلة فقط بدلا من الصفحات الكاملة.

​
اختيار الأداة المناسبة

الحاجةالأداة
بحث ويب سريع، بدون خيارات خاصةweb_search
بحث بعمق وموضوع وإجابات ذكاء اصطناعيtavily_search
استخراج محتوى من عناوين URL محددةtavily_extract
أداة web_search العامة مع Tavily كمزود تدعم query وcount (حتى 20 نتيجة). لعناصر التحكم الخاصة بـ Tavily (search_depth وtopic وinclude_answer ومرشحات النطاقات والنطاق الزمني)، استخدم tavily_search بدلا منها.

​
الإعداد المتقدم

يبحث عميل Tavily عن مفتاح API الخاص به بهذا الترتيب:
  1. plugins.entries.tavily.config.webSearch.apiKey (يُحل عبر SecretRefs).
  2. TAVILY_API_KEY من بيئة Gateway.
يرفع tavily_extract خطأ إعداد إذا لم يكن أي منهما موجودا.
تجاوز plugins.entries.tavily.config.webSearch.baseUrl إذا كنت تضع Tavily خلف وكيل. الافتراضي هو https://api.tavily.com.
يرفض tavily_extract الاستدعاءات التي تمرر chunks_per_source بدون query. ترتب Tavily المقاطع حسب صلتها بالاستعلام، لذلك لا معنى للمعامل بدونه.

​
ذات صلة

نظرة عامة على بحث الويب

جميع المزودين وقواعد الاكتشاف التلقائي.

Firecrawl

البحث بالإضافة إلى الكشط مع استخراج المحتوى.

Exa Search

بحث عصبي مع استخراج المحتوى.

الإعداد

مخطط الإعداد الكامل لإدخالات Plugin وتوجيه الأدوات.