Langsung ke konten utama

​
Brave Search API

OpenClaw mendukung Brave Search API sebagai penyedia web_search.

​
Dapatkan kunci API

  1. Buat akun Brave Search API di https://brave.com/search/api/
  2. Di dashboard, pilih paket Search dan buat kunci API.
  3. Simpan kunci di config atau setel BRAVE_API_KEY di environment Gateway.

​
Contoh config

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // atau "llm-context"
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}
Pengaturan pencarian Brave yang spesifik untuk penyedia sekarang berada di bawah plugins.entries.brave.config.webSearch.*. tools.web.search.apiKey lama masih dimuat melalui compatibility shim, tetapi itu bukan lagi jalur config kanonis. webSearch.mode mengontrol transport Brave:
  • web (default): pencarian web Brave normal dengan judul, URL, dan cuplikan
  • llm-context: API Brave LLM Context dengan potongan teks dan sumber yang sudah diekstrak untuk grounding

​
Parameter tool

ParameterDeskripsi
queryKueri pencarian (wajib)
countJumlah hasil yang dikembalikan (1-10, default: 5)
countryKode negara ISO 2 huruf (misalnya, “US”, “DE”)
languageKode bahasa ISO 639-1 untuk hasil pencarian (misalnya, “en”, “de”, “fr”)
search_langKode bahasa pencarian Brave (misalnya, en, en-gb, zh-hans)
ui_langKode bahasa ISO untuk elemen UI
freshnessFilter waktu: day (24j), week, month, atau year
date_afterHanya hasil yang dipublikasikan setelah tanggal ini (YYYY-MM-DD)
date_beforeHanya hasil yang dipublikasikan sebelum tanggal ini (YYYY-MM-DD)
Contoh: 
// Pencarian spesifik negara dan bahasa
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Hasil terbaru (minggu lalu)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Pencarian rentang tanggal
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

​
Catatan

  • OpenClaw menggunakan paket Brave Search. Jika Anda memiliki langganan lama (misalnya paket Free asli dengan 2.000 kueri/bulan), langganan itu tetap valid tetapi tidak mencakup fitur-fitur baru seperti LLM Context atau batas laju yang lebih tinggi.
  • Setiap paket Brave menyertakan $5/bulan dalam kredit gratis (diperbarui). Paket Search berbiaya $5 per 1.000 permintaan, jadi kredit itu mencakup 1.000 kueri/bulan. Setel batas penggunaan Anda di dashboard Brave untuk menghindari biaya tak terduga. Lihat portal Brave API untuk paket saat ini.
  • Paket Search mencakup endpoint LLM Context dan hak inferensi AI. Menyimpan hasil untuk melatih atau menyetel model memerlukan paket dengan hak penyimpanan eksplisit. Lihat Brave Ketentuan Layanan.
  • Mode llm-context mengembalikan entri sumber yang di-grounding alih-alih bentuk cuplikan pencarian web normal.
  • Mode llm-context tidak mendukung ui_lang, freshness, date_after, atau date_before.
  • ui_lang harus menyertakan subtanda wilayah seperti en-US.
  • Hasil dicache selama 15 menit secara default (dapat dikonfigurasi melalui cacheTtlMinutes).

​
Terkait