بحث SearXNG

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

المزايا:

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

الإعداد

openclaw plugins install @openclaw/searxng-plugin

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

ملاحظات

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

ذات صلة

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