web_search يوفّر أوضاع البحث العصبي، وبالكلمات المفتاحية، والهجين، بالإضافة إلى استخراج المحتوى المدمج (المقتطفات البارزة، والنصوص، والملخصات).
تثبيت Plugin
الحصول على مفتاح API
1
إنشاء حساب
سجّل في exa.ai وأنشئ مفتاح API من لوحة التحكم الخاصة بك.
2
تخزين المفتاح
عيّن
EXA_API_KEY في بيئة Gateway، أو اضبطه باستخدام:الإعداد
EXA_API_KEY في بيئة Gateway. عند تثبيت Gateway، ضعه في ~/.openclaw/.env. راجع متغيرات البيئة.
تجاوز عنوان URL الأساسي
عيّنplugins.entries.exa.config.webSearch.baseUrl لتوجيه طلبات بحث Exa عبر وكيل متوافق أو نقطة نهاية بديلة. يطبّع OpenClaw المضيفات المجرّدة بإضافة https:// في بدايتها، ويضيف /search ما لم يكن المسار ينتهي به بالفعل. تُعد نقطة النهاية النهائية جزءًا من مفتاح ذاكرة التخزين المؤقت للبحث، لذلك لا تُشارك النتائج بين نقاط النهاية المختلفة مطلقًا.
معاملات الأداة
string
مطلوب
استعلام البحث.
number
افتراضي:"5"
عدد النتائج المطلوب إرجاعها (من 1 إلى 100، وفقًا لحدود نوع البحث في Exa).
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
وضع البحث.
'day' | 'week' | 'month' | 'year'
عامل تصفية زمني. لا يمكن دمجه مع
date_after/date_before.string
النتائج اللاحقة لهذا التاريخ (
YYYY-MM-DD).string
النتائج السابقة لهذا التاريخ (
YYYY-MM-DD).object
خيارات استخراج المحتوى (انظر أدناه).
استخراج المحتوى
مرّر كائنcontents للتحكم في المحتوى المستخرج ضمن النتائج:
إذا حُذف
contents، تستخدم Exa القيمة الافتراضية { highlights: true } كي تتضمن النتائج مقتطفات من الجمل الرئيسية. تُستمد أوصاف النتائج أولًا من المقتطفات البارزة، ثم من الملخص، ثم من النص الكامل، بحسب أول ما يتوفر منها. تحتفظ النتائج أيضًا بحقلَي highlightScores وsummary الخام من استجابة Exa API عند توفرهما.
أوضاع البحث
ملاحظات
- يقبل
countقيمة تصل إلى 100، وفقًا لحدود نوع البحث في Exa. - تُخزّن النتائج مؤقتًا لمدة 15 دقيقة افتراضيًا. اضبط الإعداد المشترك
tools.web.search.cacheTtlMinutes(بالدقائق) وtools.web.search.timeoutSeconds(القيمة الافتراضية 30 ثانية) لتغيير مدة التخزين المؤقت ومهلة الطلب لجميع مزوّديweb_search، بما في ذلك Exa.
ذو صلة
- نظرة عامة على بحث الويب — جميع المزوّدين والاكتشاف التلقائي
- Brave Search — نتائج منظّمة مع عوامل تصفية للبلد واللغة
- Perplexity Search — نتائج منظّمة مع تصفية حسب النطاق