بحث SearXNG

• مجاني وغير محدود — لا يتطلب مفتاح 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",
      },
    },
  },
}

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

​

متغير البيئة

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

​

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

​

ملاحظات

• واجهة 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 — نتائج منظّمة مع فئة مجانية