Pencarian SearXNG

• 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",
      },
    },
  },
}

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

​

Variabel lingkungan

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

​

Referensi konfigurasi plugin

​

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