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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

يدعم 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-...", // 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 من استجابة API الخاصة بـ Exa عند توفرهما
  • تُستخلص أوصاف النتائج من التمييزات أولًا، ثم الملخص، ثم النص الكامل — أيها كان متوفرًا
  • لا يمكن الجمع بين freshness وdate_after/date_before — استخدم وضع ترشيح زمني واحد
  • يمكن إرجاع ما يصل إلى 100 نتيجة لكل استعلام (وفقًا لحدود نوع البحث في Exa)
  • تُخزّن النتائج مؤقتًا لمدة 15 دقيقة افتراضيًا (قابلة للضبط عبر cacheTtlMinutes)
  • Exa تكامل API رسمي مع استجابات JSON منظّمة

​
ذات صلة