Tools
بحث Exa
OpenClaw يدعم Exa AI بصفته موفّر web_search. يوفّر Exa
أوضاع بحث عصبية وبالكلمات المفتاحية وهجينة مع استخراج محتوى مدمج
(المقتطفات المميزة، النص، الملخصات).
تثبيت Plugin
ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway:
openclaw plugins install @openclaw/exa-pluginopenclaw gateway restartالحصول على مفتاح API
أنشئ حسابًا
سجّل في exa.ai وأنشئ مفتاح API من لوحة التحكم الخاصة بك.
خزّن المفتاح
عيّن EXA_API_KEY في بيئة Gateway، أو اضبطه عبر:
openclaw configure --section webالإعداد
{ plugins: { entries: { exa: { config: { webSearch: { apiKey: "exa-...", // optional if EXA_API_KEY is set baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search }, }, }, }, }, tools: { web: { search: { provider: "exa", }, }, },}بديل البيئة: عيّن EXA_API_KEY في بيئة Gateway.
لتثبيت Gateway، ضعه في ~/.openclaw/.env.
تجاوز عنوان URL الأساسي
عيّن plugins.entries.exa.config.webSearch.baseUrl عندما ينبغي أن تمر طلبات بحث Exa
عبر وكيل متوافق أو نقطة نهاية Exa بديلة. يطبّع OpenClaw أسماء المضيفين المجردة
بإضافة https:// في بدايتها ويضيف /search ما لم يكن المسار ينتهي بها بالفعل.
تُدرج نقطة النهاية المحلولة في مفتاح ذاكرة التخزين المؤقت للبحث، لذلك لا تتم مشاركة
النتائج من نقاط نهاية Exa المختلفة.
معلمات الأداة
querystringrequiredاستعلام البحث.
countnumberالنتائج المطلوب إرجاعها (1–100).
type'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'وضع البحث.
freshness'day' | 'week' | 'month' | 'year'عامل تصفية الوقت.
date_afterstringالنتائج بعد هذا التاريخ (YYYY-MM-DD).
date_beforestringالنتائج قبل هذا التاريخ (YYYY-MM-DD).
contentsobjectخيارات استخراج المحتوى (انظر أدناه).
استخراج المحتوى
يمكن أن يعيد Exa محتوى مستخرجًا إلى جانب نتائج البحث. مرّر كائن contents
للتفعيل:
await web_search({ query: "transformer architecture explained", type: "neural", contents: { text: true, // full page text highlights: { numSentences: 3 }, // key sentences summary: true, // AI summary },});| خيار المحتوى | النوع | الوصف |
|---|---|---|
text |
boolean | { maxCharacters } |
استخراج نص الصفحة كاملًا |
highlights |
boolean | { maxCharacters, query, numSentences, highlightsPerUrl } |
استخراج الجمل الرئيسية |
summary |
boolean | { query } |
ملخص مولّد بالذكاء الاصطناعي |
أوضاع البحث
| الوضع | الوصف |
|---|---|
auto |
يختار Exa أفضل وضع (الافتراضي) |
neural |
بحث دلالي/قائم على المعنى |
fast |
بحث سريع بالكلمات المفتاحية |
deep |
بحث عميق وشامل |
deep-reasoning |
بحث عميق مع استدلال |
instant |
أسرع النتائج |
ملاحظات
- إذا لم يُقدَّم خيار
contents، يستخدم Exa افتراضيًا{ highlights: true }بحيث تتضمن النتائج مقتطفات من الجمل الرئيسية - تحافظ النتائج على حقلي
highlightScoresوsummaryمن استجابة Exa API عند توفرهما - تُستخلص أوصاف النتائج من المقتطفات المميزة أولًا، ثم الملخص، ثم النص الكامل — أيّها كان متاحًا
- لا يمكن دمج
freshnessمعdate_after/date_before— استخدم وضعًا واحدًا لعامل تصفية الوقت - يمكن إرجاع ما يصل إلى 100 نتيجة لكل استعلام (رهناً بحدود نوع البحث في Exa)
- تُخزّن النتائج مؤقتًا لمدة 15 دقيقة افتراضيًا (قابلة للضبط عبر
cacheTtlMinutes) - Exa هو تكامل API رسمي باستجابات JSON منظمة
ذو صلة
- نظرة عامة على بحث الويب -- كل الموفّرين والاكتشاف التلقائي
- بحث Brave -- نتائج منظمة مع عوامل تصفية البلد/اللغة
- بحث Perplexity -- نتائج منظمة مع تصفية النطاقات