Tools

Exa 検索

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

Plugin をインストール

公式 Plugin をインストールしてから、Gateway を再起動します。

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-...", // optional if EXA_API_KEY is set            baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

環境変数の代替: Gateway 環境に EXA_API_KEY を設定します。 Gateway インストールの場合は、~/.openclaw/.env に配置します。

ベース URL の上書き

Exa 検索リクエストを互換プロキシまたは代替 Exa エンドポイント経由にする必要がある場合は、plugins.entries.exa.config.webSearch.baseUrl を設定します。OpenClaw はベアホストの先頭に https:// を付けて正規化し、パスがすでにそこで終わっていない限り /search を追加します。解決済みエンドポイントは検索キャッシュキーに含まれるため、異なる Exa エンドポイントからの結果は共有されません。

ツールパラメーター

querystringrequired

検索クエリ。

countnumber

返す結果数（1〜100）。

検索モード。

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

時間フィルター。

date_afterstring

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

date_beforestring

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

contentsobject

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

コンテンツ抽出

Exa は、検索結果とあわせて抽出済みコンテンツを返すことができます。有効にするには contents オブジェクトを渡します。

javascript

await web_search({  query: "transformer architecture explained",  type: "neural",  contents: {    text: true, // full page text    highlights: { numSentences: 3 }, // key sentences    summary: true, // AI summary  },});

Contents オプション	型	説明
`text`	`boolean \| { maxCharacters }`	ページ全文テキストを抽出
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	重要な文を抽出
`summary`	`boolean \| { query }`	AI 生成の要約

検索モード

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

注記

contents オプションが指定されていない場合、Exa はデフォルトで { highlights: true } を使用するため、結果には重要な文の抜粋が含まれます
利用可能な場合、結果は Exa API レスポンスの highlightScores フィールドと summary フィールドを保持します
結果の説明は、ハイライト、要約、全文テキストの順に、利用可能なものから解決されます
freshness と date_after/date_before は併用できません。時間フィルターモードはどちらか一方を使用してください
クエリごとに最大 100 件の結果を返せます（Exa 検索タイプの制限に依存）
結果はデフォルトで 15 分間キャッシュされます（cacheTtlMinutes で構成可能）
Exa は構造化 JSON レスポンスを備えた公式 API 統合です