メインコンテンツへスキップ
Tavily は AI アプリケーション向けに設計された検索 API です。OpenClaw はこれを 2 つの方法で公開します。
  • 汎用検索ツールの web_search プロバイダーとして
  • 明示的なプラグインツールとして: tavily_search と tavily_extract
Tavily は、LLM での利用に最適化された構造化結果を返します。検索深度、トピックフィルタリング、ドメインフィルター、AI 生成の回答要約、URL からのコンテンツ抽出（JavaScript レンダリングページを含む）を設定できます。
プロパティ値
Plugin IDtavily
パッケージ@openclaw/tavily-plugin
認証TAVILY_API_KEY env var または config apiKey
ベース URLhttps://api.tavily.com（デフォルト）; 上書きするには TAVILY_BASE_URL env var または config baseUrl
タイムアウト30s search、60s extract（デフォルト）
ツールtavily_search, tavily_extract

​
はじめに

1

プラグインをインストールする

openclaw plugins install @openclaw/tavily-plugin
2

API キーを取得する

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

プラグインとプロバイダーを設定する

{
  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

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

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

​
ツールリファレンス

汎用の web_search ではなく、Tavily 固有の検索制御を使いたい場合に使用します。
パラメーター型制約 / デフォルト説明
querystring必須検索クエリ文字列。
search_depthenumbasic（デフォルト）, advancedadvanced は遅くなりますが関連性が高くなります。
topicenumgeneral（デフォルト）, news, financeトピックファミリーでフィルタリングします。
max_resultsinteger1-20、デフォルト 5結果の件数。
include_answerbooleanデフォルト falseTavily AI 生成の回答要約を含めます。
time_rangeenumday, week, month, year新しさで結果をフィルタリングします。
include_domainsstring array（なし）これらのドメインからの結果のみを含めます。
exclude_domainsstring array（なし）これらのドメインからの結果を除外します。
検索深度のトレードオフ:
深度速度関連性最適な用途
basic高速高い汎用クエリ（デフォルト）。
advanced低速最高精密な調査と事実確認。

​
tavily_extract

1 つ以上の URL からクリーンなコンテンツを抽出するために使用します。JavaScript レンダリングページを処理でき、対象を絞った抽出向けにクエリ重視のチャンク化をサポートします。
パラメーター型制約 / デフォルト説明
urlsstring array必須、1-20コンテンツを抽出する URL。
querystring（任意）このクエリとの関連性で抽出チャンクを再ランキングします。
extract_depthenumbasic（デフォルト）, advancedJS の多いページ、SPA、動的テーブルには advanced を使用します。
chunks_per_sourceinteger1-5; query が必要URL ごとに返すチャンク数。query なしで設定するとエラーになります。
include_imagesbooleanデフォルト false結果に画像 URL を含めます。
抽出深度のトレードオフ:
深度使用する場面
basicシンプルなページ。まずはこちらを試してください。
advancedJS レンダリング SPA、動的コンテンツ、テーブル。
大きな URL リストは複数の tavily_extract 呼び出しに分割してください（1 リクエストあたり最大 20 件）。ページ全体ではなく関連コンテンツのみを取得するには、query と chunks_per_source を併用します。

​
適切なツールの選択

ニーズツール
クイックな Web 検索、特別なオプションなしweb_search
深度、トピック、AI 回答付きの検索tavily_search
特定の URL からコンテンツを抽出tavily_extract
プロバイダーとして 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 を設定します。config は env var より優先されます。デフォルトは https://api.tavily.com です。
tavily_extract は、query なしで chunks_per_source を渡す呼び出しを拒否します。Tavily はクエリ関連性でチャンクをランキングするため、クエリがない場合このパラメーターに意味はありません。

​
関連

Web Search の概要

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

Firecrawl

コンテンツ抽出付きの検索とスクレイピング。

Exa Search

コンテンツ抽出付きのニューラル検索。

設定

プラグインエントリーとツールルーティングの完全な config スキーマ。