Tools

Exa検索

Exa AI は、ニューラル、キーワード、ハイブリッドの検索モードと、組み込みのコンテンツ抽出（ハイライト、テキスト、要約）を備えた web_search プロバイダーです。

Plugin をインストール

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

API キーを取得

アカウントを作成

exa.ai で登録し、ダッシュボードから API キーを生成します。

キーを保存

Gateway 環境に EXA_API_KEY を設定するか、次のコマンドで構成します。

bash

openclaw configure --section web

構成

json5

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // EXA_API_KEY が設定されている場合は省略可能            baseUrl: "https://api.exa.ai", // 省略可能。OpenClaw が /search を追加          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

環境変数を使用する方法: Gateway 環境に EXA_API_KEY を設定します。Gateway をインストールした環境では、~/.openclaw/.env に追加してください。環境変数を参照してください。

ベース URL の上書き

Exa の検索リクエストを互換プロキシまたは代替エンドポイント経由で送信するには、plugins.entries.exa.config.webSearch.baseUrl を設定します。OpenClaw は、スキームのないホストの先頭に https:// を付加して正規化し、パスの末尾がすでに /search でない限り /search を追加します。解決されたエンドポイントは検索キャッシュキーの一部となるため、異なるエンドポイントの結果が共有されることはありません。

ツールのパラメーター

querystringrequired

検索クエリ。

countnumberdefault: 5

返す結果の件数（1～100、Exa の検索タイプの制限に従います）。

検索モード。

freshness'day' | 'week' | 'month' | 'year'

期間フィルター。date_after/date_before とは併用できません。

date_afterstring

この日付より後の結果（YYYY-MM-DD）。

date_beforestring

この日付より前の結果（YYYY-MM-DD）。

contentsobject

コンテンツ抽出オプション（以下を参照）。

コンテンツ抽出

結果から抽出するコンテンツを制御するには、contents オブジェクトを渡します。

javascript

await web_search({  query: "transformer architecture explained",  type: "neural",  contents: {    text: true, // ページ全文    highlights: { numSentences: 3 }, // 重要な文    summary: true, // AI による要約  },});

コンテンツオプション	型	説明
`text`	`boolean \| { maxCharacters }`	ページ全文を抽出
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	重要な文を抽出
`summary`	`boolean \| { query }`	AI によって生成された要約

contents を省略すると、Exa はデフォルトで { highlights: true } を使用するため、結果には重要な文の抜粋が含まれます。結果の説明には、最初に利用可能なものとして、ハイライト、要約、全文の順に使用されます。また、Exa API のレスポンスに含まれている場合、元の highlightScores フィールドと summary フィールドも結果に保持されます。

検索モード

モード	説明
`auto`	Exa が最適なモードを選択（デフォルト）
`neural`	セマンティック／意味ベースの検索
`fast`	高速なキーワード検索
`deep`	網羅的な詳細検索
`deep-reasoning`	推論を伴う詳細検索
`instant`	最速の結果

注意事項

count には最大 100 を指定できますが、Exa の検索タイプの制限に従います。
結果はデフォルトで 15 分間キャッシュされます。Exa を含むすべての web_search プロバイダーについて、キャッシュ時間とリクエストのタイムアウトを変更するには、共有設定の tools.web.search.cacheTtlMinutes（分）と tools.web.search.timeoutSeconds（デフォルトは 30 秒）を構成します。