Tavily

Tavily adalah API pencarian yang dirancang untuk aplikasi AI. OpenClaw menyediakannya dalam dua cara:

sebagai penyedia web_search untuk alat pencarian generik
sebagai alat Plugin eksplisit: tavily_search dan tavily_extract

Tavily mengembalikan hasil terstruktur yang dioptimalkan untuk digunakan oleh LLM, dengan kedalaman pencarian yang dapat dikonfigurasi, pemfilteran topik, filter domain, ringkasan jawaban yang dihasilkan AI, serta ekstraksi konten dari URL (termasuk halaman yang dirender dengan JavaScript).

Properti	Nilai
ID Plugin	`tavily`
Paket	`@openclaw/tavily-plugin`
Autentikasi	variabel lingkungan `TAVILY_API_KEY` atau konfigurasi `apiKey`
URL dasar	`https://api.tavily.com` (bawaan); variabel lingkungan `TAVILY_BASE_URL` atau konfigurasi `baseUrl` untuk menggantinya
Batas waktu	pencarian 30 dtk., ekstraksi 60 dtk. (bawaan)
Alat	`tavily_search`, `tavily_extract`

Memulai

Instal Plugin

openclaw plugins install @openclaw/tavily-plugin

Dapatkan kunci API

Buat akun Tavily di tavily.com, lalu buat kunci API di dasbor.

Konfigurasikan Plugin dan penyedia

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // opsional jika TAVILY_API_KEY ditetapkan
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}

Verifikasi pencarian berjalan

Picu web_search dari agen mana pun, atau panggil tavily_search secara langsung.

Memilih Tavily saat orientasi awal atau melalui openclaw configure --section web akan menginstal dan mengaktifkan Plugin Tavily resmi bila diperlukan.

Referensi alat

`tavily_search`

Gunakan ini ketika Anda menginginkan kontrol pencarian khusus Tavily, bukan web_search generik.

Parameter	Tipe	Batasan / bawaan	Deskripsi
`query`	string	wajib	String kueri pencarian.
`search_depth`	enum	`basic` (bawaan), `advanced`	`advanced` lebih lambat, tetapi relevansinya lebih tinggi.
`topic`	enum	`general` (bawaan), `news`, `finance`	Filter berdasarkan kelompok topik.
`max_results`	integer	1-20, bawaan `5`	Jumlah hasil.
`include_answer`	boolean	bawaan `false`	Sertakan ringkasan jawaban yang dihasilkan AI Tavily.
`time_range`	enum	`day`, `week`, `month`, `year`	Filter hasil berdasarkan kebaruan.
`include_domains`	array string	(tidak ada)	Hanya sertakan hasil dari domain-domain ini.
`exclude_domains`	array string	(tidak ada)	Kecualikan hasil dari domain-domain ini.

Kompromi kedalaman pencarian:

Kedalaman	Kecepatan	Relevansi	Paling sesuai untuk
`basic`	Lebih cepat	Tinggi	Kueri serbaguna (bawaan).
`advanced`	Lebih lambat	Tertinggi	Riset presisi dan pencarian fakta.

`tavily_extract`

Gunakan ini untuk mengekstrak konten bersih dari satu atau beberapa URL. Mendukung halaman yang dirender dengan JavaScript serta pembagian potongan yang berfokus pada kueri untuk ekstraksi tertarget.

Parameter	Tipe	Batasan / bawaan	Deskripsi
`urls`	array string	wajib, 1-20	URL sumber konten yang akan diekstrak.
`query`	string	(opsional)	Urutkan ulang potongan hasil ekstraksi berdasarkan relevansinya dengan kueri ini.
`extract_depth`	enum	`basic` (bawaan), `advanced`	Gunakan `advanced` untuk halaman sarat JS, SPA, atau tabel dinamis.
`chunks_per_source`	integer	1-5; memerlukan `query`	Jumlah potongan yang dikembalikan per URL. Menghasilkan galat jika ditetapkan tanpa `query`.
`include_images`	boolean	bawaan `false`	Sertakan URL gambar dalam hasil.

Kompromi kedalaman ekstraksi:

Kedalaman	Waktu penggunaan
`basic`	Halaman sederhana. Coba ini terlebih dahulu.
`advanced`	SPA yang dirender JS, konten dinamis, dan tabel.

Bagi daftar URL yang lebih besar menjadi beberapa panggilan tavily_extract (maks. 20 per permintaan). Gunakan query bersama chunks_per_source untuk hanya mendapatkan konten yang relevan, bukan halaman lengkap.

Memilih alat yang tepat

Kebutuhan	Alat
Pencarian web cepat tanpa opsi khusus	`web_search`
Pencarian dengan kedalaman, topik, jawaban AI	`tavily_search`
Mengekstrak konten dari URL tertentu	`tavily_extract`

Alat web_search generik dengan Tavily sebagai penyedia mendukung query dan count (hingga 20 hasil). Untuk kontrol khusus Tavily (search_depth, topic, include_answer, filter domain, rentang waktu), gunakan tavily_search.

Konfigurasi lanjutan

Urutan resolusi kunci API

Klien Tavily mencari kunci API dalam urutan berikut:

plugins.entries.tavily.config.webSearch.apiKey (diresolusikan melalui SecretRefs).
TAVILY_API_KEY dari lingkungan Gateway.

tavily_search dan tavily_extract sama-sama memunculkan galat penyiapan jika keduanya tidak tersedia.

URL dasar khusus

Ganti plugins.entries.tavily.config.webSearch.baseUrl, atau tetapkan TAVILY_BASE_URL, jika Anda mengakses Tavily melalui proksi. Konfigurasi diprioritaskan daripada variabel lingkungan. Nilai bawaannya adalah https://api.tavily.com.

`chunks_per_source` memerlukan `query`

tavily_extract menolak panggilan yang meneruskan chunks_per_source tanpa query. Tavily mengurutkan potongan berdasarkan relevansinya dengan kueri, sehingga parameter tersebut tidak bermakna tanpa kueri.

Terkait

Ikhtisar Pencarian Web

Semua penyedia dan aturan deteksi otomatis.

Firecrawl

Pencarian beserta pengambilan data dengan ekstraksi konten.

Pencarian Exa

Pencarian neural dengan ekstraksi konten.

Konfigurasi

Skema konfigurasi lengkap untuk entri Plugin dan perutean alat.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Memulai

Referensi alat

`tavily_search`

`tavily_extract`

Memilih alat yang tepat

Konfigurasi lanjutan

Terkait

Ikhtisar Pencarian Web

Firecrawl

Pencarian Exa

Konfigurasi

​Memulai

​Referensi alat

​tavily_search

​tavily_extract

​Memilih alat yang tepat

​Konfigurasi lanjutan

​Terkait

Ikhtisar Pencarian Web

Firecrawl

Pencarian Exa

Konfigurasi

Memulai

Referensi alat

`tavily_search`

`tavily_extract`

Memilih alat yang tepat

Konfigurasi lanjutan

Terkait