Tools

بحث Exa

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

تثبيت Plugin

ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway:

bash
openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

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

  • أنشئ حسابًا

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

  • خزّن المفتاح

    عيّن EXA_API_KEY في بيئة Gateway، أو اضبطه عبر:

    bash
    openclaw configure --section web
  • الإعداد

    json5
    {  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 للتفعيل:

    javascript
    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 منظمة

    ذو صلة

    Was this useful?
    On this page

    On this page