Ana içeriğe atla
Tavily, AI uygulamaları için tasarlanmış bir arama API’sidir. OpenClaw bunu iki şekilde sunar:
  • genel arama aracı için web_search sağlayıcısı olarak
  • açık Plugin araçları olarak: tavily_search ve tavily_extract
Tavily, yapılandırılabilir arama derinliği, konu filtreleme, alan adı filtreleri, AI tarafından oluşturulan yanıt özetleri ve URL’lerden içerik çıkarma (JavaScript ile işlenen sayfalar dahil) ile LLM tüketimi için optimize edilmiş yapılandırılmış sonuçlar döndürür.
ÖzellikDeğer
Plugin kimliğitavily
Paket@openclaw/tavily-plugin
Kimlik doğrulamaTAVILY_API_KEY veya config apiKey
Temel URLhttps://api.tavily.com (varsayılan)
Araçlartavily_search, tavily_extract

​
Başlarken

1

Plugin'i yükleyin

openclaw plugins install @openclaw/tavily-plugin
2

API anahtarı alın

tavily.com adresinde bir Tavily hesabı oluşturun, ardından panoda bir API anahtarı oluşturun.
3

Plugin'i ve sağlayıcıyı yapılandırın

{
  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",
      },
    },
  },
}
4

Aramanın çalıştığını doğrulayın

Herhangi bir agent’tan web_search tetikleyin veya doğrudan tavily_search çağırın.
Onboarding sırasında veya openclaw configure --section web ile Tavily seçmek, gerektiğinde resmi Tavily Plugin’ini yükler ve etkinleştirir.

​
Araç başvurusu

Genel web_search yerine Tavily’ye özgü arama kontrolleri istediğinizde bunu kullanın.
ParametreTürKısıtlamalar / varsayılanAçıklama
querystringgerekliArama sorgusu dizesi. 400 karakterin altında tutun.
search_depthenumbasic (varsayılan), advancedadvanced daha yavaştır ancak daha yüksek alaka düzeyi sağlar.
topicenumgeneral (varsayılan), news, financeKonu ailesine göre filtreleyin.
max_resultsinteger1-20Sonuç sayısı.
include_answerbooleanvarsayılan falseTavily AI tarafından oluşturulan yanıt özetini ekleyin.
time_rangeenumday, week, month, yearSonuçları güncelliğe göre filtreleyin.
include_domainsstring array(yok)Yalnızca bu alan adlarından gelen sonuçları dahil edin.
exclude_domainsstring array(yok)Bu alan adlarından gelen sonuçları hariç tutun.
Arama derinliği karşılaştırması:
DerinlikHızAlaka düzeyiEn iyi kullanım
basicDaha hızlıYüksekGenel amaçlı sorgular (varsayılan).
advancedDaha yavaşEn yüksekHassas araştırma ve bilgi doğrulama.

​
tavily_extract

Bunu bir veya daha fazla URL’den temiz içerik çıkarmak için kullanın. JavaScript ile işlenen sayfaları işler ve hedefli çıkarma için sorgu odaklı parçalara ayırmayı destekler.
ParametreTürKısıtlamalar / varsayılanAçıklama
urlsstring arraygerekli, 1-20İçerik çıkarılacak URL’ler.
querystring(isteğe bağlı)Çıkarılan parçaları bu sorguyla alakalarına göre yeniden sıralayın.
extract_depthenumbasic (varsayılan), advancedJS ağırlıklı sayfalar, SPA’lar veya dinamik tablolar için advanced kullanın.
chunks_per_sourceinteger1-5; query gerektirirURL başına döndürülen parçalar. query olmadan ayarlanırsa hata verir.
include_imagesbooleanvarsayılan falseSonuçlara görsel URL’lerini dahil edin.
Çıkarma derinliği karşılaştırması:
DerinlikNe zaman kullanılmalı
basicBasit sayfalar. Önce bunu deneyin.
advancedJS ile işlenen SPA’lar, dinamik içerik, tablolar.
Daha büyük URL listelerini birden çok tavily_extract çağrısına bölün (istek başına en fazla 20). Tam sayfalar yerine yalnızca ilgili içeriği almak için query ile chunks_per_source kullanın.

​
Doğru aracı seçme

İhtiyaçAraç
Hızlı web araması, özel seçenek yokweb_search
Derinlik, konu, AI yanıtlarıyla aramatavily_search
Belirli URL’lerden içerik çıkarmatavily_extract
Sağlayıcı olarak Tavily kullanılan genel web_search aracı query ve count destekler (en fazla 20 sonuç). Tavily’ye özgü kontroller (search_depth, topic, include_answer, alan adı filtreleri, zaman aralığı) için bunun yerine tavily_search kullanın.

​
Gelişmiş yapılandırma

Tavily istemcisi API anahtarını şu sırayla arar:
  1. plugins.entries.tavily.config.webSearch.apiKey (SecretRefs üzerinden çözümlenir).
  2. Gateway ortamından TAVILY_API_KEY.
Hiçbiri yoksa tavily_extract bir kurulum hatası oluşturur.
Tavily’yi bir proxy üzerinden sunuyorsanız plugins.entries.tavily.config.webSearch.baseUrl değerini geçersiz kılın. Varsayılan https://api.tavily.com değeridir.
tavily_extract, query olmadan chunks_per_source ileten çağrıları reddeder. Tavily parçaları sorgu alakasına göre sıralar, bu nedenle parametre sorgu olmadan anlamsızdır.

​
İlgili

Web Search genel bakışı

Tüm sağlayıcılar ve otomatik algılama kuralları.

Firecrawl

İçerik çıkarmalı arama ve scraping.

Exa Search

İçerik çıkarmalı sinirsel arama.

Yapılandırma

Plugin girdileri ve araç yönlendirme için tam config şeması.