---
read_when:
- Anda menginginkan pencarian web yang didukung Tavily
- Anda memerlukan kunci API Tavily
- Anda ingin Tavily sebagai penyedia web_search
- Anda ingin ekstraksi konten dari URL
summary: Alat pencarian dan ekstraksi Tavily
title: Tavily
x-i18n:
generated_at: "2026-06-27T18:21:59Z"
model: gpt-5.5
postprocess_version: locale-links-v1
provider: openai
source_hash: 539e76120e858129dabfb85c1fe379837fc87be491d5a57803917bf6bb7018ae
source_path: tools/tavily.md
workflow: 16
---
[Tavily](https://tavily.com) adalah API pencarian yang dirancang untuk aplikasi AI. OpenClaw mengeksposnya 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 konsumsi LLM dengan kedalaman pencarian yang dapat dikonfigurasi, pemfilteran topik, filter domain, ringkasan jawaban yang dihasilkan AI, dan ekstraksi konten dari URL (termasuk halaman yang dirender JavaScript).
| Properti | Nilai |
| --------- | ----------------------------------- |
| ID Plugin | `tavily` |
| Paket | `@openclaw/tavily-plugin` |
| Autentikasi | `TAVILY_API_KEY` atau config `apiKey` |
| URL Dasar | `https://api.tavily.com` (default) |
| Alat | `tavily_search`, `tavily_extract` |
## Memulai
```bash
openclaw plugins install @openclaw/tavily-plugin
```
Buat akun Tavily di [tavily.com](https://tavily.com), lalu buat kunci API di dasbor.
```json5
{
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",
},
},
},
}
```
Picu `web_search` dari agen mana pun, atau panggil `tavily_search` secara langsung.
Memilih Tavily saat onboarding atau `openclaw configure --section web` akan menginstal dan mengaktifkan Plugin resmi Tavily saat diperlukan.
## Referensi alat
### `tavily_search`
Gunakan ini saat Anda menginginkan kontrol pencarian khusus Tavily alih-alih `web_search` generik.
| Parameter | Jenis | Batasan / default | Deskripsi |
| ----------------- | ------------ | -------------------------------------- | ----------------------------------------------- |
| `query` | string | wajib | String kueri pencarian. Jaga agar di bawah 400 karakter. |
| `search_depth` | enum | `basic` (default), `advanced` | `advanced` lebih lambat tetapi relevansinya lebih tinggi. |
| `topic` | enum | `general` (default), `news`, `finance` | Filter berdasarkan keluarga topik. |
| `max_results` | integer | 1-20 | Jumlah hasil. |
| `include_answer` | boolean | default `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 ini. |
| `exclude_domains` | array string | (tidak ada) | Kecualikan hasil dari domain ini. |
Tradeoff kedalaman pencarian:
| Kedalaman | Kecepatan | Relevansi | Paling cocok untuk |
| ---------- | -------------- | ----------- | ------------------------------------ |
| `basic` | Lebih cepat | Tinggi | Kueri serbaguna (default). |
| `advanced` | Lebih lambat | Tertinggi | Riset presisi dan pencarian fakta. |
### `tavily_extract`
Gunakan ini untuk mengekstrak konten bersih dari satu atau beberapa URL. Menangani halaman yang dirender JavaScript dan mendukung pemotongan berbasis kueri untuk ekstraksi terarah.
| Parameter | Jenis | Batasan / default | Deskripsi |
| ------------------- | ------------ | ----------------------------- | ----------------------------------------------------------- |
| `urls` | array string | wajib, 1-20 | URL untuk mengekstrak konten. |
| `query` | string | (opsional) | Urutkan ulang potongan yang diekstrak berdasarkan relevansi terhadap kueri ini. |
| `extract_depth` | enum | `basic` (default), `advanced` | Gunakan `advanced` untuk halaman berat JS, SPA, atau tabel dinamis. |
| `chunks_per_source` | integer | 1-5; **memerlukan `query`** | Potongan yang dikembalikan per URL. Error jika diatur tanpa `query`. |
| `include_images` | boolean | default `false` | Sertakan URL gambar dalam hasil. |
Tradeoff kedalaman ekstraksi:
| Kedalaman | Kapan digunakan |
| ---------- | ------------------------------------------ |
| `basic` | Halaman sederhana. Coba ini terlebih dahulu. |
| `advanced` | SPA yang dirender JS, konten dinamis, tabel. |
Bagi daftar URL yang lebih besar ke beberapa panggilan `tavily_extract` (maks 20 per permintaan). Gunakan `query` plus `chunks_per_source` untuk mendapatkan hanya konten yang relevan alih-alih halaman penuh.
## Memilih alat yang tepat
| Kebutuhan | Alat |
| ------------------------------------ | ---------------- |
| Pencarian web cepat, tanpa opsi khusus | `web_search` |
| Pencarian dengan kedalaman, topik, jawaban AI | `tavily_search` |
| Ekstrak 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` sebagai gantinya.
## Konfigurasi lanjutan
Klien Tavily mencari kunci API-nya dalam urutan ini:
1. `plugins.entries.tavily.config.webSearch.apiKey` (di-resolve melalui SecretRefs).
2. `TAVILY_API_KEY` dari lingkungan gateway.
`tavily_extract` memunculkan error penyiapan jika tidak ada yang tersedia.
Timpa `plugins.entries.tavily.config.webSearch.baseUrl` jika Anda menempatkan Tavily di belakang proxy. Default-nya adalah `https://api.tavily.com`.
`tavily_extract` menolak panggilan yang meneruskan `chunks_per_source` tanpa `query`. Tavily memeringkat potongan berdasarkan relevansi kueri, sehingga parameter ini tidak bermakna tanpa kueri.
## Terkait
Semua penyedia dan aturan deteksi otomatis.
Pencarian plus scraping dengan ekstraksi konten.
Pencarian neural dengan ekstraksi konten.
Skema config lengkap untuk entri Plugin dan perutean alat.