الانتقال إلى المحتوى الرئيسي

​
بحث SearXNG

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

​
الإعداد

1

شغّل مثيل SearXNG

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

الإعداد

openclaw configure --section web
# Select "searxng" as the provider
أو اضبط متغير البيئة ودع الاكتشاف التلقائي يعثر عليه:
export SEARXNG_BASE_URL="http://localhost:8888"

​
الإعدادات

{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}
إعدادات على مستوى الإضافة لمثيل 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://

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

اضبط SEARXNG_BASE_URL كبديل عن الإعدادات: 
export SEARXNG_BASE_URL="http://localhost:8888"
عند ضبط SEARXNG_BASE_URL وعدم تهيئة مزوّد صريح، يختار الاكتشاف التلقائي SearXNG تلقائيًا (بأدنى أولوية — أي مزوّد مدعوم بواجهة API ومهيأ بمفتاح يفوز أولًا).

​
مرجع إعدادات الإضافة

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

​
ملاحظات

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

​
ذو صلة