SearXNG araması

OpenClaw, kendi barındırdığınız ve anahtar gerektirmeyen bir web_search sağlayıcısı olarak SearXNG desteği sunar. SearXNG; Google, Bing, DuckDuckGo ve diğer kaynaklardan gelen sonuçları bir araya getiren açık kaynaklı bir meta arama motorudur.

Avantajlar:

• Ücretsiz ve sınırsız -- API anahtarı veya ticari abonelik gerekmez
• Gizlilik / ağdan yalıtım -- sorgular ağınızdan asla çıkmaz
• Her yerde çalışır -- ticari arama API'lerinin bölge kısıtlamaları yoktur

Kurulum

openclaw plugins install @openclaw/searxng-plugin

docker run -d -p 8888:8080 searxng/searxng

openclaw configure --section web# Sağlayıcı olarak "searxng" seçin

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

Yapılandırma

{  tools: {    web: {      search: {        provider: "searxng",      },    },  },}

SearXNG örneğine ilişkin Plugin düzeyi ayarlar:

{  plugins: {    entries: {      searxng: {        config: {          webSearch: {            baseUrl: "http://localhost:8888",            categories: "general,news", // isteğe bağlı            language: "en", // isteğe bağlı          },        },      },    },  },}

baseUrl ayrıca bir SecretRef nesnesini de kabul eder (örneğin { source: "env", id: "SEARXNG_BASE_URL" }).

Ortam değişkeni

Yapılandırmaya alternatif olarak SEARXNG_BASE_URL değerini ayarlayın:

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

Çözümleme sırası: yapılandırılmış baseUrl dizesi, ardından baseUrl üzerindeki satır içi bir ortam SecretRef'i ve son olarak SEARXNG_BASE_URL. Yapılandırma yollarından hiçbiri ayarlanmamışsa, SEARXNG_BASE_URL mevcutsa ve açıkça bir sağlayıcı seçilmemişse otomatik algılama SearXNG'yi seçer.

Plugin yapılandırma referansı

web_search araç çağrısı ayrıca her çağrıya özel geçersiz kılmalar olarak count (1-10 sonuç), categories ve language değerlerini kabul eder.

Notlar

• JSON API -- HTML kazıma yerine SearXNG'nin yerel format=json uç noktasını kullanır
• Görsel sonucu URL'leri -- SearXNG doğrudan görsel URL'si döndürdüğünde görsel kategorisi sonuçları img_src içerir
• API anahtarı yok -- herhangi bir SearXNG örneğiyle doğrudan çalışır
• Temel URL doğrulaması -- baseUrl, geçerli bir http:// veya https:// URL'si olmalıdır
• Ağ koruması -- http:// temel URL'leri güvenilir bir özel veya local loopback ana bilgisayarını hedeflemelidir (herkese açık ana bilgisayarlar https:// kullanmalıdır); özel/dahili bir adrese çözümlenen https:// temel URL'leri aynı kendi kendine barındırma iznini alırken, herkese açık bir adrese çözümlenen https:// temel URL'leri katı SSRF korumasını sürdürür
• Otomatik algılama sırası -- SearXNG yapılandırılmış bir baseUrl gerektirir (gerekli kimlik bilgilerine zaten sahip sağlayıcılar arasında sıra 200). DuckDuckGo veya Ollama Web Search gibi anahtar gerektirmeyen sağlayıcılar otomatik algılamada hiçbir zaman örtük olarak seçilmez; yalnızca açık bir provider seçimiyle etkinleşirler
• Kendi kendine barındırma -- örneği, sorguları ve yukarı akış arama motorlarını siz denetlersiniz
• Kategoriler, yapılandırılmadığında varsayılan olarak general değerini kullanır
• Kategori geri dönüşü -- general dışındaki bir kategori isteği başarılı olur ancak sıfır sonuç döndürürse OpenClaw, boş bir sonuç kümesi döndürmeden önce aynı sorguyu general ile bir kez daha dener
• Sonuç önbelleğe alma -- özdeş sorgular (aynı sorgu, sayı, kategoriler, dil ve temel URL) kısa bir TTL süresince işlem içinde önbelleğe alınır
• Sürüm gereksinimi -- Plugin, minHostVersion: >=2026.6.9 bildiriminde bulunur

İlgili

• Web Araması genel bakışı -- tüm sağlayıcılar ve otomatik algılama
• DuckDuckGo Araması -- anahtar gerektirmeyen başka bir sağlayıcı
• Brave Araması -- ücretsiz katmanlı yapılandırılmış sonuçlar