Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Dapatkan API key

1

Buat akun

Daftar di exa.ai dan buat API key dari dashboard Anda.
2

Simpan kunci

Atur 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: atur EXA_API_KEY di lingkungan Gateway. Untuk instalasi gateway, letakkan di ~/.openclaw/.env.

Penggantian URL dasar

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

Parameter tool

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 yang dihasilkan 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 menggunakan default { highlights: true } sehingga hasil menyertakan cuplikan kalimat kunci
  • Hasil mempertahankan field highlightScores dan summary dari respons API Exa jika tersedia
  • Deskripsi hasil diselesaikan dari sorotan terlebih dahulu, lalu ringkasan, lalu teks penuh — 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 (tunduk pada batas tipe pencarian Exa)
  • Hasil di-cache selama 15 menit secara default (dapat dikonfigurasi melalui cacheTtlMinutes)
  • Exa adalah integrasi API resmi dengan respons JSON terstruktur

Terkait