SearXNG araması

OpenClaw, kendi barındırdığınız, anahtarsız bir web_search sağlayıcısı olarak SearXNG desteği sunar. SearXNG, Google, Bing, DuckDuckGo ve diğer kaynaklardan sonuçları birleştiren açık kaynaklı bir meta arama motorudur.

Avantajlar:

• Ücretsiz ve sınırsız -- API anahtarı veya ticari abonelik gerekmez
• Gizlilik / izole ağ -- sorgular ağınızdan dışarı çıkmaz
• Her yerde çalışır -- ticari arama API'lerinde bölge kısıtlaması yoktur

Kurulum

openclaw plugins install @openclaw/searxng-plugin

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

openclaw configure --section web# Select "searxng" as the provider

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", // optional            language: "en", // optional          },        },      },    },  },}

baseUrl alanı SecretRef nesnelerini de kabul eder.

Aktarım kuralları:

• https://, herkese açık veya özel SearXNG ana makineleri için çalışır
• http:// yalnızca güvenilir özel ağ veya loopback ana makineleri için kabul edilir
• herkese açık SearXNG ana makineleri https:// kullanmalıdır
• özel/dahili ana makineler kendi barındırılan ağ korumasını kullanır; herkese açık https:// ana makineler katı web araması korumasında kalır ve özel adreslere yönlendirme yapamaz

Ortam değişkeni

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

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

SEARXNG_BASE_URL ayarlandığında ve açık bir sağlayıcı yapılandırılmadığında, otomatik algılama SearXNG'yi otomatik olarak seçer (en düşük öncelikte -- anahtarı olan API destekli herhangi bir sağlayıcı önce kazanır).

Plugin yapılandırma referansı

Notlar

• JSON API -- HTML kazıma değil, SearXNG'nin yerel format=json uç noktasını kullanır
• Görsel sonuç URL'leri -- görsel kategorisi sonuçları, SearXNG doğrudan görsel URL'si döndürdüğünde img_src içerir
• API anahtarı yok -- kutudan çıktığı gibi herhangi bir SearXNG örneğiyle çalışır
• Temel URL doğrulaması -- baseUrl geçerli bir http:// veya https:// URL'si olmalıdır; herkese açık ana makineler https:// kullanmalıdır
• Ağ koruması -- özel/dahili SearXNG uç noktaları özel ağ erişimine dahil olur; herkese açık https:// SearXNG uç noktaları katı SSRF korumasını sürdürür
• Otomatik algılama sırası -- SearXNG, yapılandırılmış anahtarları olan API destekli sağlayıcılardan sonra denetlenir (sıra 200). DuckDuckGo veya Ollama Web Search gibi anahtarsız sağlayıcılar, açık bir sağlayıcı seçimi olmadan otomatik olarak seçilmez
• Kendi barındırma -- örneği, sorguları ve yukarı akış arama motorlarını siz kontrol edersiniz
• Kategoriler, yapılandırılmadığında varsayılan olarak general değerini alır
• Kategori geri dönüşü -- general dışı bir kategori isteği başarılı olur ancak sıfır sonuç döndürürse OpenClaw, boş sonuç kümesi döndürmeden önce aynı sorguyu bir kez general ile yeniden dener

İlgili

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