Ana içeriğe atla

​
SearXNG Search

OpenClaw, kendi barındırdığınız, anahtar gerektirmeyen bir web_search sağlayıcısı olarak SearXNG’yi destekler. SearXNG, sonuçları Google, Bing, DuckDuckGo ve diğer kaynaklardan toplayan 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ızın dışına çıkmaz
  • Her yerde çalışır — ticari arama API’lerinde bölge kısıtlamaları yoktur

​
Kurulum

1

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

docker run -d -p 8888:8080 searxng/searxng
Veya erişiminiz olan mevcut bir SearXNG dağıtımını kullanın. Üretim kurulumu için SearXNG belgelerine bakın.
2

Yapılandırın

openclaw configure --section web
# Sağlayıcı olarak "searxng" seçin
Veya env var ayarlayıp otomatik algılamanın bunu bulmasını sağlayın:
export SEARXNG_BASE_URL="http://localhost:8888"

​
Config

{
  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 alanı SecretRef nesnelerini de kabul eder. Aktarım kuralları:
  • https:// genel veya özel SearXNG ana bilgisayarları için çalışır
  • http:// yalnızca güvenilen özel ağ veya loopback ana bilgisayarları için kabul edilir
  • genel SearXNG ana bilgisayarları https:// kullanmalıdır

​
Ortam değişkeni

Config’e alternatif olarak SEARXNG_BASE_URL ayarlayın: 
export SEARXNG_BASE_URL="http://localhost:8888"
SEARXNG_BASE_URL ayarlandığında ve açıkça bir sağlayıcı yapılandırılmadığında, otomatik algılama SearXNG’yi otomatik olarak seçer (en düşük öncelikte — anahtarı olan herhangi bir API destekli sağlayıcı önce kazanır).

​
Plugin config referansı

AlanAçıklama
baseUrlSearXNG örneğinizin temel URL’si (zorunlu)
categoriesgeneral, news veya science gibi virgülle ayrılmış kategoriler
languageen, de veya fr gibi sonuçlar için dil kodu

​
Notlar

  • JSON API — HTML scraping değil, SearXNG’nin yerel format=json uç noktasını kullanır
  • 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 bilgisayarlar https:// kullanmalıdır
  • Otomatik algılama sırası — SearXNG, otomatik algılamada en son (sıra 200) kontrol edilir. 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)
  • Kendi barındırdığınız — örneği, sorguları ve üst akış arama motorlarını siz kontrol edersiniz
  • Categories yapılandırılmadığında varsayılan olarak general olur
SearXNG JSON API’nin çalışması için SearXNG örneğinizde json biçiminin settings.yml içindeki search.formats altında etkin olduğundan emin olun.

​
İlgili