جست‌وجوی SearXNG

OpenClaw از SearXNG به‌عنوان ارائه‌دهنده‌ی web_search خودمیزبان و بدون نیاز به کلید پشتیبانی می‌کند. SearXNG یک موتور فرا جست‌وجوی متن‌باز است که نتایج را از Google، Bing، DuckDuckGo و منابع دیگر گردآوری می‌کند.

مزایا:

• رایگان و نامحدود -- به کلید API یا اشتراک تجاری نیاز ندارد
• حریم خصوصی / شبکه‌ی ایزوله -- پرس‌وجوها هرگز از شبکه‌ی شما خارج نمی‌شوند
• در هرجا کار می‌کند -- محدودیت‌های منطقه‌ای APIهای جست‌وجوی تجاری را ندارد

# راه‌اندازی

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

# نکات

• API JSON -- از نقطه‌ی پایانی بومی format=json در SearXNG استفاده می‌کند، نه استخراج از HTML
• URLهای نتایج تصویر -- نتایج دسته‌ی تصویر وقتی SearXNG یک URL مستقیم تصویر برگرداند، شامل img_src هستند
• بدون کلید API -- با هر نمونه‌ی SearXNG بدون تنظیمات اضافه کار می‌کند
• اعتبارسنجی URL پایه -- baseUrl باید یک URL معتبر http:// یا https:// باشد؛ میزبان‌های عمومی باید از https:// استفاده کنند
• محافظ شبکه -- نقاط پایانی خصوصی/داخلی SearXNG برای دسترسی به شبکه‌ی خصوصی opt in می‌کنند؛ نقاط پایانی عمومی https:// SearXNG محافظت سخت‌گیرانه‌ی SSRF را حفظ می‌کنند
• ترتیب تشخیص خودکار -- SearXNG در تشخیص خودکار آخر از همه بررسی می‌شود (ترتیب 200). ارائه‌دهندگان مبتنی بر API با کلیدهای پیکربندی‌شده ابتدا اجرا می‌شوند، سپس DuckDuckGo (ترتیب 100)، سپس Ollama Web Search (ترتیب 110)
• خودمیزبان -- شما نمونه، پرس‌وجوها و موتورهای جست‌وجوی بالادستی را کنترل می‌کنید
• دسته‌ها وقتی پیکربندی نشده باشند، به‌طور پیش‌فرض general هستند
• بازگشت دسته -- اگر درخواست دسته‌ای غیر از general موفق شود اما هیچ نتیجه‌ای برنگرداند، OpenClaw همان پرس‌وجو را پیش از برگرداندن مجموعه‌نتایج خالی، یک‌بار با general دوباره امتحان می‌کند

# مرتبط

• نمای کلی جست‌وجوی وب -- همه‌ی ارائه‌دهندگان و تشخیص خودکار
• جست‌وجوی DuckDuckGo -- یک fallback دیگر بدون نیاز به کلید
• جست‌وجوی Brave -- نتایج ساختاریافته با سطح رایگان