Tools

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ı bir araya getiren açık kaynaklı bir meta arama motorudur.

Avantajlar:

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

Kurulum

  • Bir SearXNG örneği çalıştırın

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

    Ya da erişiminiz olan mevcut herhangi bir SearXNG dağıtımını kullanın. Üretim kurulumu için SearXNG belgelerine bakın.

  • Yapılandırın

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

    Ya da env var değerini ayarlayın ve otomatik algılamanın bunu bulmasına izin verin:

    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:// genel veya özel SearXNG ana makineleri için çalışır
    • http:// yalnızca güvenilir özel ağ veya loopback ana makineleri için kabul edilir
    • genel SearXNG ana makineleri https:// kullanmalıdır
    • özel/dahili ana makineler kendi barındırılan ağ korumasını kullanır; genel https:// ana makineleri katı web arama 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 -- anahtara sahip API destekli herhangi bir sağlayıcı önce kazanır).

    Plugin yapılandırma başvurusu

    Alan Açıklama
    baseUrl SearXNG örneğinizin temel URL'si (gerekli)
    categories general, news veya science gibi virgülle ayrılmış kategoriler
    language Sonuçlar için en, de veya fr gibi dil kodu

    Notlar

    • JSON API -- HTML kazıma yerine SearXNG'nin yerel format=json uç noktasını kullanır
    • Görüntü sonucu URL'leri -- görüntü kategorisi sonuçları, SearXNG doğrudan bir görüntü URL'si döndürdüğünde img_src içerir
    • API anahtarı yok -- herhangi bir SearXNG örneğiyle kutudan çıktığı gibi çalışır
    • Temel URL doğrulaması -- baseUrl geçerli bir http:// veya https:// URL'si olmalıdır; genel ana makineler https:// kullanmalıdır
    • Ağ koruması -- özel/dahili SearXNG uç noktaları özel ağ erişimine katılır; genel https:// SearXNG uç noktaları katı SSRF korumasını sürdürür
    • Otomatik algılama sırası -- SearXNG, otomatik algılamada en son denetlenir (sıra 200). Yapılandırılmış anahtarlara sahip API destekli sağlayıcılar önce çalışır, ardından DuckDuckGo (sıra 100), ardından Ollama Web Search (sıra 110) gelir
    • Kendi barındırılan -- örneği, sorguları ve yukarı akış arama motorlarını siz denetlersiniz
    • Kategoriler yapılandırılmadığında varsayılan olarak general olur
    • Kategori geri dönüşü -- general olmayan 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 bir kez general ile yeniden dener

    İlgili