Pencarian SearXNG

OpenClaw mendukung SearXNG sebagai penyedia web_search yang dihosting sendiri, tanpa kunci. SearXNG adalah mesin meta-pencarian open-source yang menggabungkan hasil dari Google, Bing, DuckDuckGo, dan sumber lain.

Keunggulan:

• Gratis dan tidak terbatas -- tidak memerlukan kunci API atau langganan komersial
• Privasi / isolasi jaringan -- kueri tidak pernah meninggalkan jaringan Anda
• Berfungsi di mana saja -- tidak ada pembatasan wilayah pada API pencarian komersial

Penyiapan

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"

Konfigurasi

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

Pengaturan tingkat Plugin untuk instance 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 publik https:// tetap berada pada pelindung pencarian web yang ketat dan tidak dapat mengalihkan ke alamat privat

Variabel lingkungan

Tetapkan SEARXNG_BASE_URL sebagai alternatif untuk konfigurasi:

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

Ketika SEARXNG_BASE_URL ditetapkan dan tidak ada penyedia eksplisit yang dikonfigurasi, deteksi otomatis memilih SearXNG secara otomatis (dengan prioritas terendah -- penyedia berbasis API apa pun dengan kunci akan menang terlebih dahulu).

Referensi konfigurasi Plugin

Catatan

• API JSON -- menggunakan endpoint native format=json milik SearXNG, bukan scraping HTML
• URL hasil gambar -- hasil kategori gambar menyertakan img_src ketika SearXNG mengembalikan URL gambar langsung
• Tidak ada kunci API -- berfungsi dengan instance SearXNG apa pun secara langsung
• Validasi URL dasar -- baseUrl harus berupa URL http:// atau https:// yang valid; host publik harus menggunakan https://
• Pelindung jaringan -- endpoint SearXNG privat/internal ikut serta dalam akses jaringan privat; endpoint SearXNG publik https:// tetap mempertahankan perlindungan SSRF yang ketat
• Urutan deteksi otomatis -- SearXNG diperiksa setelah penyedia berbasis API dengan kunci yang dikonfigurasi (urutan 200). Penyedia tanpa kunci seperti DuckDuckGo atau Ollama Web Search tidak dipilih otomatis tanpa pilihan penyedia eksplisit
• Dihosting sendiri -- Anda mengontrol instance, kueri, dan mesin pencari upstream
• Kategori default ke general jika tidak dikonfigurasi
• Fallback kategori -- jika permintaan kategori non-general berhasil tetapi mengembalikan nol hasil, OpenClaw mencoba ulang kueri yang sama satu kali dengan general sebelum mengembalikan kumpulan hasil kosong

Terkait

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