Langsung ke konten utama
OpenClaw mendukung Exa AI sebagai penyedia web_search. Exa menawarkan mode pencarian neural, kata kunci, dan hibrida dengan ekstraksi konten bawaan (sorotan, teks, ringkasan).

Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway:
openclaw plugins install @openclaw/exa-plugin
openclaw gateway restart

Dapatkan kunci API

1

Buat akun

Daftar di exa.ai dan buat kunci API dari dasbor Anda.
2

Simpan kunci

Tetapkan EXA_API_KEY di lingkungan Gateway, atau konfigurasikan melalui:
openclaw configure --section web

Konfigurasi

{
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // optional if EXA_API_KEY is set
            baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}
Alternatif lingkungan: tetapkan EXA_API_KEY di lingkungan Gateway. Untuk instalasi gateway, letakkan di ~/.openclaw/.env.

Penggantian URL dasar

Tetapkan plugins.entries.exa.config.webSearch.baseUrl ketika permintaan pencarian Exa harus melewati proksi yang kompatibel atau endpoint Exa alternatif. OpenClaw menormalkan host polos dengan menambahkan https:// di depan dan menambahkan /search kecuali jalurnya sudah berakhir di sana. Endpoint yang dihasilkan disertakan dalam kunci cache pencarian, sehingga hasil dari endpoint Exa yang berbeda tidak dibagikan.

Parameter alat

query
string
wajib
Kueri pencarian.
count
number
Hasil yang akan dikembalikan (1–100).
type
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
Mode pencarian.
freshness
'day' | 'week' | 'month' | 'year'
Filter waktu.
date_after
string
Hasil setelah tanggal ini (YYYY-MM-DD).
date_before
string
Hasil sebelum tanggal ini (YYYY-MM-DD).
contents
object
Opsi ekstraksi konten (lihat di bawah).

Ekstraksi konten

Exa dapat mengembalikan konten yang diekstrak bersama hasil pencarian. Berikan objek contents untuk mengaktifkan:
await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // full page text
    highlights: { numSentences: 3 }, // key sentences
    summary: true, // AI summary
  },
});
Opsi contentsTipeDeskripsi
textboolean | { maxCharacters }Ekstrak teks halaman penuh
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }Ekstrak kalimat kunci
summaryboolean | { query }Ringkasan buatan AI

Mode pencarian

ModeDeskripsi
autoExa memilih mode terbaik (default)
neuralPencarian semantik/berbasis makna
fastPencarian kata kunci cepat
deepPencarian mendalam yang menyeluruh
deep-reasoningPencarian mendalam dengan penalaran
instantHasil tercepat

Catatan

  • Jika tidak ada opsi contents yang diberikan, Exa secara default menggunakan { highlights: true } sehingga hasil menyertakan cuplikan kalimat kunci
  • Hasil mempertahankan bidang highlightScores dan summary dari respons API Exa saat tersedia
  • Deskripsi hasil diambil dari sorotan terlebih dahulu, lalu ringkasan, lalu teks lengkap — mana pun yang tersedia
  • freshness dan date_after/date_before tidak dapat digabungkan — gunakan satu mode filter waktu
  • Hingga 100 hasil dapat dikembalikan per kueri (bergantung pada batas tipe pencarian Exa)
  • Hasil disimpan dalam cache selama 15 menit secara default (dapat dikonfigurasi melalui cacheTtlMinutes)
  • Exa adalah integrasi API resmi dengan respons JSON terstruktur

Terkait