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 を末尾に追加します。パスはすでにそこで終わっています。解決されたエンドポイントは検索キャッシュキーの一部であるため、異なるエンドポイントの結果が共有されることはありません。

ツールパラメーター

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: "トランスフォーマーアーキテクチャの解説",  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 には、Exa の検索タイプの上限に従い、最大 100 まで指定できます。
結果はデフォルトで 15 分間キャッシュされます。すべての web_search プロバイダー（Exa を含む）のキャッシュとリクエストタイムアウトを変更するには、共有の tools.web.search.cacheTtlMinutes（分）と tools.web.search.timeoutSeconds（デフォルト 30 秒）を設定します。