الانتقال إلى المحتوى الرئيسي
OpenClaw يدعم Exa AI بصفته موفّر web_search. يوفّر Exa أوضاع بحث عصبية وبالكلمات المفتاحية وهجينة مع استخراج محتوى مدمج (المقتطفات المميزة، النص، الملخصات).

​
تثبيت Plugin

ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway: 
openclaw plugins install @openclaw/exa-plugin
openclaw gateway restart

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

1

أنشئ حسابًا

سجّل في exa.ai وأنشئ مفتاح API من لوحة التحكم الخاصة بك.
2

خزّن المفتاح

عيّن 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 المختلفة.

​
معلمات الأداة

​
query
string
مطلوب
استعلام البحث.
​
count
number
النتائج المطلوب إرجاعها (1–100).
​
type
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
وضع البحث.
​
freshness
'day' | 'week' | 'month' | 'year'
عامل تصفية الوقت.
​
date_after
string
النتائج بعد هذا التاريخ (YYYY-MM-DD).
​
date_before
string
النتائج قبل هذا التاريخ (YYYY-MM-DD).
​
contents
object
خيارات استخراج المحتوى (انظر أدناه).

​
استخراج المحتوى

يمكن أن يعيد 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
  },
});
خيار المحتوىالنوعالوصف
textboolean | { maxCharacters }استخراج نص الصفحة كاملًا
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }استخراج الجمل الرئيسية
summaryboolean | { 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 منظمة

​
ذو صلة