Pencarian SearXNG

OpenClaw mendukung SearXNG sebagai penyedia web_search dihosting sendiri, tanpa kunci. SearXNG adalah mesin metapencari sumber terbuka yang mengagregasi hasil dari Google, Bing, DuckDuckGo, dan sumber lain.

Keunggulan:

• Gratis dan tanpa batas -- tidak memerlukan kunci API atau langganan komersial
• Privasi / isolasi jaringan -- kueri tidak pernah keluar dari jaringan Anda
• Berfungsi di mana saja -- tidak ada batasan wilayah pada API pencarian komersial

# Penyiapan

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

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

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

# Konfigurasi

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

Pengaturan tingkat Plugin untuk instans SearXNG:

{
  plugins: {
    entries: {
      searxng: {
        config: {
          webSearch: {
            baseUrl: "http://localhost:8888",
            categories: "general,news", // optional
            language: "en", // optional
          },
        },
      },
    },
  },
}

Kolom baseUrl juga menerima objek SecretRef.

Aturan transport:

• https:// berfungsi untuk host SearXNG publik atau privat
• http:// hanya diterima untuk host jaringan privat tepercaya atau loopback
• host SearXNG publik harus menggunakan https://
• host privat/internal menggunakan pelindung jaringan yang dihosting sendiri; host https:// publik tetap berada pada pelindung pencarian web yang ketat dan tidak dapat mengalihkan ke alamat privat

# Variabel lingkungan

Atur SEARXNG_BASE_URL sebagai alternatif konfigurasi:

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

Saat SEARXNG_BASE_URL diatur dan tidak ada penyedia eksplisit yang dikonfigurasi, deteksi otomatis memilih SearXNG secara otomatis (dengan prioritas terendah -- penyedia berbasis API apa pun dengan kunci akan dipilih lebih dulu).

# Referensi konfigurasi Plugin

# Catatan

• API JSON -- menggunakan endpoint asli SearXNG format=json, bukan scraping HTML
• URL hasil gambar -- hasil kategori gambar menyertakan img_src saat SearXNG mengembalikan URL gambar langsung
• Tanpa kunci API -- berfungsi dengan instans SearXNG apa pun langsung dari awal
• Validasi URL dasar -- baseUrl harus berupa URL http:// atau https:// yang valid; host publik harus menggunakan https://
• Pelindung jaringan -- endpoint SearXNG privat/internal memilih untuk mengaktifkan akses jaringan privat; endpoint SearXNG https:// publik mempertahankan perlindungan SSRF yang ketat
• Urutan deteksi otomatis -- SearXNG diperiksa terakhir (urutan 200) dalam deteksi otomatis. Penyedia berbasis API dengan kunci yang dikonfigurasi berjalan lebih dulu, lalu DuckDuckGo (urutan 100), lalu Ollama Web Search (urutan 110)
• Dihosting sendiri -- Anda mengendalikan instans, kueri, dan mesin pencari upstream
• Kategori default ke general saat tidak dikonfigurasi
• Fallback kategori -- jika permintaan kategori non-general berhasil tetapi mengembalikan nol hasil, OpenClaw mencoba ulang kueri yang sama sekali lagi dengan general sebelum mengembalikan kumpulan hasil kosong

# Terkait

• Ikhtisar Web Search -- semua penyedia dan deteksi otomatis
• DuckDuckGo Search -- fallback tanpa kunci lainnya
• Brave Search -- hasil terstruktur dengan tingkat gratis