Langsung ke konten utama
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

1

Install the plugin

openclaw plugins install @openclaw/searxng-plugin
2

Run a SearXNG instance

docker run -d -p 8888:8080 searxng/searxng
Atau gunakan deployment SearXNG yang sudah ada dan dapat Anda akses. Lihat dokumentasi SearXNG untuk penyiapan produksi.
3

Configure

openclaw configure --section web
# Select "searxng" as the provider
Atau tetapkan env var dan biarkan deteksi otomatis menemukannya:
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

KolomDeskripsi
baseUrlURL dasar instance SearXNG Anda (wajib)
categoriesKategori yang dipisahkan koma seperti general, news, atau science
languageKode bahasa untuk hasil seperti en, de, atau fr

​
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
Agar API JSON SearXNG berfungsi, pastikan instance SearXNG Anda telah mengaktifkan format json di settings.yml pada bagian search.formats.

​
Terkait