メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Tavily は、AIアプリケーション向けに設計された検索APIです。OpenClaw では、次の2つの方法で公開されています。
  • 汎用検索ツールの web_search provider として
  • 明示的な Plugin ツールとして: tavily_search と tavily_extract
Tavily は、設定可能な検索深度、トピックフィルタリング、ドメインフィルター、AI生成の回答要約、URLからのコンテンツ抽出（JavaScriptでレンダリングされるページを含む）を備えた、LLMでの利用に最適化された構造化結果を返します。
プロパティ値
Plugin IDtavily
認証TAVILY_API_KEY または config apiKey
ベースURLhttps://api.tavily.com (デフォルト)
同梱ツールtavily_search, tavily_extract

​
はじめに

1

APIキーを取得する

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

Plugin と provider を設定する

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

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

任意の agent から web_search をトリガーするか、tavily_search を直接呼び出します。
オンボーディングまたは openclaw configure --section web で Tavily を選択すると、同梱の Tavily Plugin が自動的に有効になります。

​
ツールリファレンス

汎用の web_search ではなく、Tavily 固有の検索制御を使用したい場合に使います。
パラメーター型制約 / デフォルト説明
query文字列必須検索クエリ文字列。400文字未満にしてください。
search_depth列挙型basic (デフォルト), advancedadvanced は遅いものの、関連性が高くなります。
topic列挙型general (デフォルト), news, financeトピックファミリーでフィルタリングします。
max_results整数1-20結果の数。
include_answer真偽値デフォルト falseTavily のAI生成回答要約を含めます。
time_range列挙型day, week, month, year新しさで結果をフィルタリングします。
include_domains文字列配列(なし)これらのドメインからの結果のみを含めます。
exclude_domains文字列配列(なし)これらのドメインからの結果を除外します。
検索深度のトレードオフ:
深度速度関連性最適な用途
basic高速高い汎用クエリ (デフォルト)。
advanced低速最高精密な調査と事実確認。

​
tavily_extract

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

​
適切なツールの選択

必要なことツール
特別なオプションなしのクイックWeb検索web_search
深度、トピック、AI回答を指定した検索tavily_search
特定URLからのコンテンツ抽出tavily_extract
Tavily を provider とする汎用 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_extract はセットアップエラーを発生させます。
プロキシ経由で Tavily を利用する場合は、plugins.entries.tavily.config.webSearch.baseUrl を上書きします。デフォルトは https://api.tavily.com です。
tavily_extract は、query なしで chunks_per_source を渡す呼び出しを拒否します。Tavily はクエリとの関連性でチャンクをランク付けするため、このパラメーターはクエリなしでは意味を持ちません。

​
関連

Web Search の概要

すべての provider と自動検出ルール。

Firecrawl

検索に加えてコンテンツ抽出付きのスクレイピング。

Exa Search

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

設定

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