بحث Exa

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

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

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

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

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

يمكن لـ 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
  },
});

# أوضاع البحث

# ملاحظات

• إذا لم يتم توفير خيار contents، يستخدم Exa افتراضيًا { highlights: true } بحيث تتضمن النتائج مقتطفات من الجمل الرئيسية
• تحتفظ النتائج بحقلي highlightScores وsummary من استجابة API الخاصة بـ Exa عند توفرهما
• تُستخلص أوصاف النتائج من التمييزات أولًا، ثم الملخص، ثم النص الكامل — أيها كان متوفرًا
• لا يمكن الجمع بين freshness وdate_after/date_before — استخدم وضع ترشيح زمني واحد
• يمكن إرجاع ما يصل إلى 100 نتيجة لكل استعلام (وفقًا لحدود نوع البحث في Exa)
• تُخزّن النتائج مؤقتًا لمدة 15 دقيقة افتراضيًا (قابلة للضبط عبر cacheTtlMinutes)
• Exa تكامل API رسمي مع استجابات JSON منظّمة

# ذات صلة

• نظرة عامة على بحث الويب -- جميع الموفرين والاكتشاف التلقائي
• Brave Search -- نتائج منظّمة مع مرشحات البلد/اللغة
• Perplexity Search -- نتائج منظّمة مع ترشيح النطاقات