Langsung ke konten utama

​
Tavily

OpenClaw dapat menggunakan Tavily dengan dua cara:
  • sebagai provider web_search
  • sebagai tool plugin eksplisit: tavily_search dan tavily_extract
Tavily adalah API pencarian yang dirancang untuk aplikasi AI, mengembalikan hasil terstruktur yang dioptimalkan untuk konsumsi LLM. Tavily mendukung kedalaman pencarian yang dapat dikonfigurasi, pemfilteran topik, filter domain, ringkasan jawaban yang dihasilkan AI, dan ekstraksi konten dari URL (termasuk halaman yang dirender dengan JavaScript).

​
Dapatkan API key

  1. Buat akun Tavily di tavily.com.
  2. Buat API key di dashboard.
  3. Simpan di konfigurasi atau setel TAVILY_API_KEY di environment gateway.

​
Konfigurasikan pencarian Tavily

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
Catatan:
  • Memilih Tavily saat onboarding atau openclaw configure --section web akan mengaktifkan plugin Tavily bawaan secara otomatis.
  • Simpan konfigurasi Tavily di bawah plugins.entries.tavily.config.webSearch.*.
  • web_search dengan Tavily mendukung query dan count (hingga 20 hasil).
  • Untuk kontrol khusus Tavily seperti search_depth, topic, include_answer, atau filter domain, gunakan tavily_search.

​
Tool plugin Tavily

Gunakan ini saat Anda menginginkan kontrol pencarian khusus Tavily alih-alih web_search generik.
ParameterDeskripsi
queryString kueri pencarian (usahakan di bawah 400 karakter)
search_depthbasic (default, seimbang) atau advanced (relevansi tertinggi, lebih lambat)
topicgeneral (default), news (pembaruan real-time), atau finance
max_resultsJumlah hasil, 1-20 (default: 5)
include_answerSertakan ringkasan jawaban yang dihasilkan AI (default: false)
time_rangeFilter berdasarkan kebaruan: day, week, month, atau year
include_domainsArray domain untuk membatasi hasil
exclude_domainsArray domain untuk dikecualikan dari hasil
Kedalaman pencarian:
DepthKecepatanRelevansiPaling cocok untuk
basicLebih cepatTinggiKueri tujuan umum (default)
advancedLebih lambatTertinggiPresisi, fakta spesifik, riset

​
tavily_extract

Gunakan ini untuk mengekstrak konten bersih dari satu atau beberapa URL. Menangani halaman yang dirender dengan JavaScript dan mendukung chunking yang berfokus pada kueri untuk ekstraksi yang ditargetkan.
ParameterDeskripsi
urlsArray URL untuk diekstrak (1-20 per permintaan)
queryUrutkan ulang chunk hasil ekstraksi berdasarkan relevansi ke kueri ini
extract_depthbasic (default, cepat) atau advanced (untuk halaman yang banyak JS)
chunks_per_sourceChunk per URL, 1-5 (memerlukan query)
include_imagesSertakan URL gambar dalam hasil (default: false)
Kedalaman ekstraksi:
DepthKapan digunakan
basicHalaman sederhana - coba ini terlebih dahulu
advancedSPA yang dirender JS, konten dinamis, tabel
Tips:
  • Maksimal 20 URL per permintaan. Bagi daftar yang lebih besar menjadi beberapa panggilan.
  • Gunakan query + chunks_per_source untuk hanya mendapatkan konten yang relevan alih-alih seluruh halaman.
  • Coba basic terlebih dahulu; fallback ke advanced jika konten hilang atau tidak lengkap.

​
Memilih tool yang tepat

KebutuhanTool
Pencarian web cepat, tanpa opsi khususweb_search
Pencarian dengan depth, topic, jawaban AItavily_search
Ekstraksi konten dari URL tertentutavily_extract

​
Terkait