Pencarian SearXNG

OpenClaw mendukung SearXNG sebagai penyedia web_search yang dihosting sendiri, tanpa kunci. SearXNG adalah mesin metapencarian sumber terbuka yang mengagregasikan hasil dari Google, Bing, DuckDuckGo, dan sumber lainnya.

Keunggulan:

• Gratis dan tanpa batas -- 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# Pilih "searxng" sebagai penyedia

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", // opsional            language: "en", // opsional          },        },      },    },  },}

baseUrl juga menerima objek SecretRef (misalnya { source: "env", id: "SEARXNG_BASE_URL" }).

Variabel lingkungan

Tetapkan SEARXNG_BASE_URL sebagai alternatif konfigurasi:

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

Urutan resolusi: string baseUrl yang dikonfigurasi, lalu SecretRef lingkungan sebaris pada baseUrl, kemudian SEARXNG_BASE_URL. Ketika tidak ada jalur konfigurasi yang ditetapkan dan SEARXNG_BASE_URL tersedia tanpa penyedia yang dipilih secara eksplisit, deteksi otomatis memilih SearXNG.

Referensi konfigurasi plugin

Pemanggilan alat web_search juga menerima count (1-10 hasil), categories, dan language sebagai penggantian untuk setiap pemanggilan.

Catatan

• API JSON -- menggunakan endpoint asli format=json milik SearXNG, bukan pengambilan data dari HTML
• URL hasil gambar -- hasil kategori gambar menyertakan img_src ketika SearXNG mengembalikan URL gambar langsung
• Tanpa kunci API -- langsung berfungsi dengan instans SearXNG apa pun
• Validasi URL dasar -- baseUrl harus berupa URL http:// atau https:// yang valid
• Pengaman jaringan -- URL dasar http:// harus menargetkan host privat tepercaya atau local loopback (host publik harus menggunakan https://); URL dasar https:// yang ditetapkan ke alamat privat/internal mendapat izin hosting mandiri yang sama, sedangkan URL dasar https:// yang ditetapkan secara publik tetap menggunakan perlindungan SSRF yang ketat
• Urutan deteksi otomatis -- SearXNG memerlukan baseUrl yang dikonfigurasi (urutan 200 di antara penyedia yang sudah memiliki kredensial wajib). Penyedia tanpa kunci seperti DuckDuckGo atau Ollama Web Search tidak pernah dipilih secara implisit oleh deteksi otomatis; penyedia tersebut hanya aktif jika provider dipilih secara eksplisit
• Dihosting sendiri -- Anda mengendalikan instans, kueri, dan mesin pencari hulu
• Kategori secara bawaan menggunakan general jika tidak dikonfigurasi
• Fallback kategori -- jika permintaan kategori selain general berhasil tetapi tidak menghasilkan apa pun, OpenClaw mencoba ulang kueri yang sama satu kali dengan general sebelum mengembalikan kumpulan hasil kosong
• Penyimpanan cache hasil -- kueri identik (kueri, jumlah, kategori, bahasa, dan URL dasar yang sama) disimpan dalam cache proses untuk TTL singkat
• Persyaratan versi -- plugin mendeklarasikan minHostVersion: >=2026.6.9

Terkait

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