Skip to main content
Tavily は、AI アプリケーション向けに設計された検索 API です。OpenClaw では、次の 2 つの方法で利用できます。
  • 汎用検索ツールの web_search プロバイダーとして
  • 明示的な Plugin ツールとして：tavily_search と tavily_extract
Tavily は、LLM での利用に最適化された構造化結果を返します。検索深度、トピックフィルタリング、ドメインフィルター、AI が生成する回答要約、URL からのコンテンツ抽出（JavaScript でレンダリングされるページを含む）を設定できます。

​
はじめに

1

Plugin をインストールする

2

API キーを取得する

tavily.com で Tavily アカウントを作成し、ダッシュボードで API キーを生成します。
3

Plugin とプロバイダーを設定する

4

検索が実行されることを確認する

任意のエージェントから web_search をトリガーするか、tavily_search を直接呼び出します。
オンボーディングまたは openclaw configure --section web で Tavily を選択すると、必要に応じて公式 Tavily Plugin がインストールされ、有効になります。

​
ツールリファレンス

汎用の web_search ではなく、Tavily 固有の検索制御を使用する場合に利用します。 検索深度のトレードオフ：

​
tavily_extract

1 つ以上の URL からクリーンなコンテンツを抽出する場合に利用します。JavaScript でレンダリングされるページを処理でき、対象を絞った抽出のためにクエリに基づくチャンク化をサポートします。 抽出深度のトレードオフ：
大きな URL リストは、複数の tavily_extract 呼び出しに分割してください（リクエストごとに最大 20）。ページ全体ではなく関連コンテンツのみを取得するには、query と chunks_per_source を組み合わせて使用します。

​
適切なツールの選択

Tavily をプロバイダーとして使用する汎用 web_search ツールは、query と count（最大 20 件の結果）をサポートします。Tavily 固有の制御（search_depth、topic、include_answer、ドメインフィルター、期間）には、代わりに tavily_search を使用します。

​
高度な設定

Tavily クライアントは、次の順序で API キーを検索します。
  1. plugins.entries.tavily.config.webSearch.apiKey（SecretRefs を介して解決）。
  2. Gateway 環境の TAVILY_API_KEY。
どちらも存在しない場合、tavily_search と tavily_extract はセットアップエラーを発生させます。
プロキシ経由で Tavily を利用する場合は、plugins.entries.tavily.config.webSearch.baseUrl をオーバーライドするか、TAVILY_BASE_URL を設定します。設定は環境変数より優先されます。デフォルトは https://api.tavily.com です。
tavily_extract は、query なしで chunks_per_source を渡す呼び出しを拒否します。Tavily はクエリとの関連性に基づいてチャンクを順位付けするため、クエリがなければこのパラメーターに意味はありません。

​
関連項目

ウェブ検索の概要

すべてのプロバイダーと自動検出ルール。

Firecrawl

コンテンツ抽出を伴う検索とスクレイピング。

Exa Search

コンテンツ抽出を伴うニューラル検索。

設定

Plugin エントリとツールルーティングの完全な設定スキーマ。