SearXNG araması

OpenClaw, Google, Bing, DuckDuckGo ve diğer kaynaklardan gelen sonuçları bir araya getiren açık kaynaklı bir meta arama motoru olan SearXNG'yi kendi sunucunuzda barındırılan, anahtar gerektirmeyen web_search sağlayıcısı olarak destekler.

Avantajlar:

• Ücretsiz ve sınırsız -- API anahtarı veya ticari abonelik gerekmez
• Gizlilik / ağ yalıtımı -- sorgular hiçbir zaman ağınızdan çıkmaz
• Her yerde çalışır -- ticari arama API'lerindeki 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çeneğini belirleyin

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

Yapılandırma

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

SearXNG örneği için Plugin düzeyindeki ayarlar:

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

baseUrl, 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ğişkenini 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 ortam SecretRef'i, ardından 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 başvurusu

web_search araç çağrısı, çağrı başına geçersiz kılmalar olarak count (1-10 sonuç), categories ve language değerlerini de kabul eder.

Notlar

• JSON API -- HTML kazıma yerine SearXNG'nin yerel format=json uç noktasını kullanır
• Görsel sonuç URL'leri -- SearXNG doğrudan bir görsel URL'si döndürdüğünde, görsel kategorisindeki sonuçlar img_src içerir
• API anahtarı yoktur -- herhangi bir SearXNG örneğiyle kullanıma hazır olarak ç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üvenilen bir özel veya geri döngü ana bilgisayarını hedeflemelidir (genel ana bilgisayarlar https:// kullanmalıdır); özel/dahili bir adrese çözümlenen https:// temel URL'leri aynı kendi sunucusunda barındırma iznini alırken, genel 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şir
• Kendi sunucunuzda barındırılır -- ö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 yedeği -- 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 yeniden dener
• Sonuç önbelleğe alma -- aynı sorgular (aynı sorgu, sayı, kategoriler, dil ve temel URL), kısa bir TTL boyunca işlem içinde önbelleğe alınır
• Sürüm gereksinimi -- Plugin, minHostVersion: >=2026.6.9 bildirir

İlgili

• Web Aramasına 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 katmanla yapılandırılmış sonuçlar