بحث 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",      },    },  },}

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

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

يقبل baseUrl أيضًا كائن SecretRef (مثل { source: "env", id: "SEARXNG_BASE_URL" }).

متغير البيئة

عيّن SEARXNG_BASE_URL بديلًا للإعدادات:

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

ترتيب الحل: سلسلة baseUrl المضبوطة، ثم SecretRef مضمن للبيئة في baseUrl، ثم SEARXNG_BASE_URL. عندما لا يكون أي من مسارات الإعدادات معيّنًا ويكون SEARXNG_BASE_URL موجودًا دون اختيار مزوّد صراحةً، يختار الاكتشاف التلقائي SearXNG.

مرجع إعدادات Plugin

يقبل استدعاء أداة web_search أيضًا count (من نتيجة واحدة إلى 10 نتائج)، وcategories، وlanguage كتجاوزات خاصة بكل استدعاء.

ملاحظات

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

ذو صلة

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