بحث SearXNG

يدعم OpenClaw ‏SearXNG بصفته موفر web_search مستضافًا ذاتيًا، وبدون مفتاح. SearXNG هو محرك بحث تلوي مفتوح المصدر يجمع النتائج من Google وBing وDuckDuckGo ومصادر أخرى.

المزايا:

• مجاني وغير محدود -- لا يلزم مفتاح API أو اشتراك تجاري
• الخصوصية / العزل الشبكي -- لا تغادر الاستعلامات شبكتك أبدًا
• يعمل في أي مكان -- لا توجد قيود إقليمية على واجهات API البحث التجارية

# الإعداد

docker run -d -p 8888:8080 searxng/searxng

openclaw configure --section web
# Select "searxng" as the provider

export SEARXNG_BASE_URL="http://localhost:8888"

# التكوين

{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}

إعدادات مستوى Plugin لمثيل SearXNG:

{
  plugins: {
    entries: {
      searxng: {
        config: {
          webSearch: {
            baseUrl: "http://localhost:8888",
            categories: "general,news", // optional
            language: "en", // optional
          },
        },
      },
    },
  },
}

يقبل الحقل baseUrl أيضًا كائنات SecretRef.

قواعد النقل:

• يعمل https:// لمضيفي SearXNG العامين أو الخاصين
• لا يُقبل http:// إلا للمضيفين الموثوقين على الشبكة الخاصة أو مضيفي loopback
• يجب أن يستخدم مضيفو SearXNG العامون https://
• تستخدم المضيفات الخاصة/الداخلية حارس الشبكة المستضافة ذاتيًا؛ وتبقى مضيفات https:// العامة على حارس بحث الويب الصارم ولا يمكنها إعادة التوجيه إلى عناوين خاصة

# متغير البيئة

عيّن SEARXNG_BASE_URL كبديل للتكوين:

export SEARXNG_BASE_URL="http://localhost:8888"

عند تعيين SEARXNG_BASE_URL وعدم تكوين موفر صراحةً، يختار الاكتشاف التلقائي SearXNG تلقائيًا (بأدنى أولوية -- أي موفر مدعوم بواجهة API وله مفتاح يفوز أولًا).

# مرجع تكوين Plugin

# ملاحظات

• واجهة API بتنسيق JSON -- تستخدم نقطة نهاية format=json الأصلية في SearXNG، وليس كشط HTML
• عناوين URL لنتائج الصور -- تتضمن نتائج فئة الصور img_src عندما يعيد SearXNG عنوان URL مباشرًا للصورة
• لا يوجد مفتاح API -- يعمل مع أي مثيل SearXNG مباشرةً
• التحقق من عنوان URL الأساسي -- يجب أن يكون baseUrl عنوان URL صالحًا يبدأ بـ http:// أو https://؛ ويجب أن تستخدم المضيفات العامة https://
• حارس الشبكة -- تختار نقاط نهاية SearXNG الخاصة/الداخلية الاشتراك في الوصول إلى الشبكة الخاصة؛ وتحتفظ نقاط نهاية SearXNG العامة عبر https:// بحماية SSRF الصارمة
• ترتيب الاكتشاف التلقائي -- يُفحص SearXNG أخيرًا (الترتيب 200) في الاكتشاف التلقائي. تعمل الموفرات المدعومة بواجهة API والمكوّنة بمفاتيح أولًا، ثم DuckDuckGo (الترتيب 100)، ثم Ollama Web Search (الترتيب 110)
• مستضاف ذاتيًا -- أنت تتحكم في المثيل والاستعلامات ومحركات البحث upstream
• الفئات تكون افتراضيًا general عند عدم تكوينها
• الرجوع الاحتياطي للفئة -- إذا نجح طلب فئة غير general لكنه أعاد صفر نتائج، يعيد OpenClaw محاولة الاستعلام نفسه مرة واحدة باستخدام general قبل إرجاع مجموعة نتائج فارغة

# ذات صلة

• نظرة عامة على Web Search -- جميع الموفرين والاكتشاف التلقائي
• بحث DuckDuckGo -- بديل آخر بدون مفتاح
• بحث Brave -- نتائج منظمة مع طبقة مجانية