Skip to main content
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

1

Plugin'i yükleyin

2

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

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

Yapılandırın

Alternatif olarak, ortam değişkenini ayarlayın ve otomatik algılamanın bunu bulmasına izin verin:

Yapılandırma

SearXNG örneği için Plugin düzeyindeki ayarlar:
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:
Çö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ğigeneral 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
SearXNG JSON API’nin çalışması için SearXNG örneğinizde json biçiminin settings.yml dosyasındaki search.formats altında etkinleştirildiğinden emin olun.

İlgili