الانتقال إلى المحتوى الرئيسي

​
بحث Exa

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

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

1

أنشئ حسابًا

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

خزّن المفتاح

عيّن EXA_API_KEY في بيئة Gateway، أو قم بالتهيئة عبر:
openclaw configure --section web

​
التهيئة

{
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // اختياري إذا كان EXA_API_KEY معيّنًا
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}
بديل البيئة: عيّن EXA_API_KEY في بيئة Gateway. بالنسبة إلى تثبيت Gateway، ضعه في ~/.openclaw/.env.

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

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

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

يمكن لـ Exa إرجاع محتوى مستخرج إلى جانب نتائج البحث. مرّر كائن contents للتمكين: 
await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // النص الكامل للصفحة
    highlights: { numSentences: 3 }, // الجمل الأساسية
    summary: true, // ملخص من AI
  },
});
خيار contentsالنوعالوصف
textboolean | { maxCharacters }استخراج النص الكامل للصفحة
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }استخراج الجمل الأساسية
summaryboolean | { query }ملخص منشأ بواسطة AI

​
أوضاع البحث

الوضعالوصف
autoيختار Exa أفضل وضع (الافتراضي)
neuralبحث دلالي/قائم على المعنى
fastبحث سريع بالكلمات المفتاحية
deepبحث عميق وشامل
deep-reasoningبحث عميق مع استدلال
instantأسرع النتائج

​
ملاحظات

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

​
ذو صلة