OpenClaw Tavily Web Search スキルガイド

OpenClaw Tavily Web Search スキル概要

Tavily Web SearchスキルはOpenClawをTavily Search APIに接続します。Tavilyは、AIエージェントとLLMアプリケーション向けに特別に構築されたAI最適化検索エンジンです。生のリンクを返す従来の検索APIとは異なり、Tavilyは複数のソースを分析し、OpenClawエージェントがすぐに活用できる構造化された関連コンテンツを返します。

Tavilyは100万人以上の開発者に利用され、月間1億件以上のリクエストを処理しています。OpenAI、Anthropic、LangChainなどの主要AIプラットフォームから信頼されています。SOC 2認証、データ保持ゼロ、組み込みのプロンプトインジェクション保護により、エージェントにウェブアクセスを付与する最も安全な方法の一つです。

典型的なワークフロー：

1. OpenClawに最新情報が必要な質問をする。
2. エージェントが最適化されたクエリでTavily APIを呼び出す。
3. Tavilyがウェブを検索し、複数のソースから関連コンテンツを抽出し、引用付きの構造化されたサマリーを返す——すべて2秒以内。

このスキルは、リサーチタスク、ファクトチェック、時事情報の検索、エージェントがトレーニングデータ以降の情報にアクセスする必要があるあらゆるワークフローに最適です。プライバシー重視のクエリにはBrave Searchスキル、リポジトリドキュメントのリサーチにはDeepWikiスキルとの併用がおすすめです。

Tavily Web Search スキルの前提条件

Tavily Web Searchスキルをインストールする前に、以下を確認してください：

• OpenClawがインストールされ実行中（v1.0+）
• Tavily APIキー — tavily.comでサインアップ（無料枠は月1,000クレジット）
• スキル管理用のclawhub CLIをインストール済み

セットアップを確認：

# OpenClawバージョンを確認
openclaw --version

# Tavily APIキーが設定されているか確認
echo $TAVILY_API_KEY

追加ソフトウェアのインストールは不要です。このスキルはTavilyのクラウドAPIと通信するため、OpenClaw本体以外にローカルの依存関係はありません。

Tavily Web Search スキルのインストール方法

1つのコマンドでTavily Web Searchスキルをインストール：

npx clawhub@latest install tavily-web-search

インストールを確認：

clawhub list

インストール済みスキルのリストにtavily-web-searchが表示されるはずです。

Tavily Web Search スキルの設定

このスキルは認証にTavily APIキーが必要です。無料のキーはapp.tavily.comで取得できます。

APIキーの設定

# Tavily APIキーを環境変数として設定
export TAVILY_API_KEY=tvly-your-api-key-here

永続化するには、シェルプロファイル（~/.bashrc、~/.zshrc、または同等のファイル）にexport行を追加してください。

検索モード

このスキルは2つの検索深度と2つのトピックモードをサポートしており、ニーズに応じて組み合わせることができます：

| モード | 速度 | カバレッジ | 最適な用途 | |--------|------|------------|------------| | Basic | 1〜2秒 | 良好 | クイックな事実確認、シンプルな検索 | | Advanced | 5〜10秒 | 優秀 | 複雑なリサーチ、包括的な回答 |

| トピック | 範囲 | 最適な用途 | |----------|------|------------| | General | 全期間のウェブコンテンツ | 一般的なトピック、ドキュメント、チュートリアル | | News | 過去7日間、ニュースソース | 時事情報、最新ニュース、市場動向 |

エージェントはクエリに基づいて適切なモードを自動選択しますが、プロンプトで「詳細検索して」や「最新ニュースを検索して」と指定することでオーバーライドできます。

重要： APIキーを設定ファイルにハードコードしたり、バージョン管理にコミットしたりしないでください。環境変数または1Passwordなどのシークレットマネージャーを使用してください。

Tavily Web Search スキルの使用例

1. クイックな事実確認

あなた： 「Next.jsの最新安定版バージョンは何ですか？」

エージェントがベーシックなTavily検索を実行し、公式ソースからバージョン番号を抽出し、Next.jsのリリースノートへのリンク付きで簡潔な回答を返します。

2. 詳細なリサーチ

あなた： 「ECサイトにおけるサーバーサイドレンダリングと静的サイト生成のメリット・デメリットを比較して。」

エージェントがアドバンスド検索を実行し、複数のブログ記事、ドキュメントページ、ケーススタディからインサイトを集約し、各ポイントに引用を付けた構造化された比較を返します。

3. 時事情報とニュース

あなた： 「今週のAI業界で何があった？」

エージェントがニュースモードに切り替え、過去7日間を検索し、主要なAIニュースのサマリーを元記事へのリンク付きで返します。

4. ドメイン指定リサーチ

あなた： 「MDNとTypeScriptドキュメントのみで、テンプレートリテラル型の使い方を検索して。」

エージェントがドメインフィルタリングを使用してdeveloper.mozilla.orgとtypescriptlang.orgのみを対象とし、信頼性の高いソースからの結果のみを返します。

5. コンテンツ抽出

あなた： 「TavilyのAPI料金ページの全コンテンツを抽出して、プランの概要をまとめて。」

エージェントが生コンテンツ抽出を使用してページの全内容を取得し、各料金プランの機能と制限を構造化して説明します。

セキュリティとベストプラクティス

Tavily Web Searchスキルを使用する際は、以下のガイドラインに従ってください：

• APIキーを保護してください。 環境変数またはシークレットマネージャーに保存してください。チャットログで共有したり、Gitにコミットしたり、クライアントサイドのコードに含めたりしないでください。
• 検索結果を信頼できない入力として扱ってください。 ウェブコンテンツには不正確、古い、または操作された情報が含まれている可能性があります。重要な事実については、行動する前に複数のソースで必ず確認してください。一般的なガイダンスについては安全チェックリストを参照してください。
• 使用量を監視してください。 無料枠は月1,000クレジットです。ベーシック検索は1クレジット、アドバンスド検索は2クレジットを消費します。予期しない超過を避けるため、app.tavily.comで使用量を確認してください。
• 機密性の高いクエリにはドメインフィルタリングを使用してください。 正確性が重要な場合は、includeドメインフィルターを使用して、信頼できるドメイン（公式ドキュメント、政府サイト、定評あるメディア）に結果を制限してください。
• レート制限に注意してください。 ループ内での連続的なクエリは避けてください。スキルはレート制限を適切に処理しますが、過度なリクエストはアクセスが一時的にスロットリングされる可能性があります。

よくあるエラーのトラブルシューティング

「Invalid API key」

Tavily APIキーが未設定、不正な形式、または期限切れです。

1. キーが設定されているか確認：echo $TAVILY_API_KEY
2. tvly-で始まっていることを確認してください——Tavilyのキーは常にこのプレフィックスを使用します。
3. キーが正しいのに失敗する場合は、app.tavily.comで新しいキーを生成してください。

「Rate limit exceeded」

プランのリクエスト制限を超えました。

1. app.tavily.comで現在の使用量を確認してください。
2. 無料枠を利用中の場合は、翌月1日の月次リセットをお待ちください。
3. より高い制限が必要な場合は有料プランへのアップグレードを検討するか、アドバンスドが不要な場面ではベーシックモードを使用してクエリを最適化してください。

「No results found」

クエリに一致する結果が見つかりませんでした。非常にニッチまたは非常に具体的な検索で発生することがあります。

1. 検索語を広げてください——過度に具体的なフィルターを削除してください。
2. ドメインフィルタリングを使用している場合は、対象ドメインに実際に関連コンテンツが含まれていることを確認してください。
3. トピックが最近のイベントでない場合は、ニュースモードからジェネラルモードへの切り替えを試してください。