Tavily

Tavily هي واجهة API للبحث مصممة لتطبيقات الذكاء الاصطناعي. يتيحها OpenClaw بطريقتين:

بصفتها موفّر web_search لأداة البحث العامة
بصفتها أدوات Plugin صريحة: tavily_search وtavily_extract

تُرجع Tavily نتائج منظّمة ومحسّنة لاستخدام النماذج اللغوية الكبيرة، مع عمق بحث قابل للضبط، وتصفية حسب الموضوع، ومرشحات للنطاقات، وملخصات إجابات مولّدة بالذكاء الاصطناعي، واستخراج المحتوى من عناوين URL (بما في ذلك الصفحات المعروضة باستخدام JavaScript).

الخاصية	القيمة
معرّف Plugin	`tavily`
الحزمة	`@openclaw/tavily-plugin`
المصادقة	متغير البيئة `TAVILY_API_KEY` أو إعداد `apiKey`
عنوان URL الأساسي	`https://api.tavily.com` (الافتراضي)؛ متغير البيئة `TAVILY_BASE_URL` أو إعداد `baseUrl` لتجاوزه
المُهل الزمنية	30 ثانية للبحث، و60 ثانية للاستخراج (افتراضيًا)
الأدوات	`tavily_search`، `tavily_extract`

بدء الاستخدام

تثبيت Plugin

openclaw plugins install @openclaw/tavily-plugin

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

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

تهيئة Plugin والموفّر

{
  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 أثناء الإعداد الأولي أو عبر openclaw configure --section web إلى تثبيت Plugin الرسمي لـ Tavily وتمكينه عند الحاجة.

مرجع الأدوات

`tavily_search`

استخدم هذه الأداة عندما تريد عناصر تحكم خاصة ببحث Tavily بدلًا من web_search العام.

المعامل	النوع	القيود / القيمة الافتراضية	الوصف
`query`	سلسلة نصية	مطلوب	سلسلة استعلام البحث.
`search_depth`	تعداد	`basic` (افتراضي)، `advanced`	الخيار `advanced` أبطأ لكنه أعلى صلة.
`topic`	تعداد	`general` (افتراضي)، `news`، `finance`	التصفية حسب فئة الموضوع.
`max_results`	عدد صحيح	1-20، الافتراضي `5`	عدد النتائج.
`include_answer`	قيمة منطقية	الافتراضي `false`	تضمين ملخص إجابة مولّد بالذكاء الاصطناعي من Tavily.
`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`	استخدم `advanced` للصفحات كثيفة JS أو تطبيقات SPA أو الجداول الديناميكية.
`chunks_per_source`	عدد صحيح	1-5؛ يتطلب `query`	عدد المقاطع المُعادة لكل عنوان URL. يحدث خطأ إذا ضُبط من دون `query`.
`include_images`	قيمة منطقية	الافتراضي `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 بدلًا منها.

التهيئة المتقدمة

ترتيب البحث عن مفتاح API

يبحث عميل Tavily عن مفتاح API بالترتيب التالي:

plugins.entries.tavily.config.webSearch.apiKey (بعد حله عبر SecretRefs).
TAVILY_API_KEY من بيئة Gateway.

تُصدر كل من tavily_search وtavily_extract خطأ إعداد إذا لم يكن أي منهما موجودًا.

عنوان URL أساسي مخصص

تجاوز plugins.entries.tavily.config.webSearch.baseUrl، أو اضبط TAVILY_BASE_URL، إذا كنت تمرّر Tavily عبر وكيل وسيط. تكون للتهيئة أولوية على متغير البيئة. القيمة الافتراضية هي https://api.tavily.com.

يتطلب `chunks_per_source` المعامل `query`

يرفض tavily_extract الاستدعاءات التي تمرّر chunks_per_source من دون query. ترتّب Tavily المقاطع حسب صلتها بالاستعلام، ولذلك لا معنى لهذا المعامل من دونه.

ذو صلة

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

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

Firecrawl

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

بحث Exa

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

التهيئة

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

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

بدء الاستخدام

مرجع الأدوات

`tavily_search`

`tavily_extract`

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

التهيئة المتقدمة

ذو صلة

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

Firecrawl

بحث Exa

التهيئة

​بدء الاستخدام

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

​tavily_search

​tavily_extract

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

​التهيئة المتقدمة

​ذو صلة

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

Firecrawl

بحث Exa

التهيئة

بدء الاستخدام

مرجع الأدوات

`tavily_search`

`tavily_extract`

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

التهيئة المتقدمة

ذو صلة