الانتقال إلى المحتوى الرئيسي
يدعم OpenClaw SearXNG بوصفه موفّر web_search مستضافًا ذاتيًا ومن دون مفاتيح. SearXNG هو محرك بحث تلوي مفتوح المصدر يجمع النتائج من Google وBing وDuckDuckGo ومصادر أخرى. المزايا:
  • مجاني وغير محدود — لا يلزم مفتاح API أو اشتراك تجاري
  • الخصوصية / العزل الشبكي — لا تغادر الاستعلامات شبكتك أبدًا
  • يعمل في أي مكان — لا توجد قيود مناطق على واجهات API التجارية للبحث

​
الإعداد

1

ثبّت Plugin

openclaw plugins install @openclaw/searxng-plugin
2

شغّل مثيل SearXNG

docker run -d -p 8888:8080 searxng/searxng
أو استخدم أي نشر SearXNG قائم يمكنك الوصول إليه. راجع توثيق SearXNG لإعداد الإنتاج.
3

اضبط الإعدادات

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

الحقلالوصف
baseUrlعنوان URL الأساسي لمثيل SearXNG لديك (مطلوب)
categoriesفئات مفصولة بفواصل مثل general أو news أو science
languageرمز اللغة للنتائج مثل en أو de أو fr

​
ملاحظات

  • واجهة 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 قبل إرجاع مجموعة نتائج فارغة
لكي تعمل واجهة SearXNG JSON API، تأكد من أن مثيل SearXNG لديك مفعّل فيه تنسيق json في ملف settings.yml ضمن search.formats.

​
ذات صلة