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

​
Pluginをインストール

openclaw plugins install @openclaw/exa-plugin
openclaw gateway restart

​
APIキーを取得

1

Create an account

exa.ai でサインアップし、ダッシュボードからAPIキーを生成します。
2

Store the key

Gateway環境で EXA_API_KEY を設定するか、次で構成します。
openclaw configure --section web

​
設定

{
  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 に入れます。環境変数を参照してください。

​
Base URLの上書き

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

​
ツールパラメーター

​
query
string
必須
検索クエリ。
​
count
number
デフォルト:"5"
返す結果数（1-100、Exaの検索タイプ制限に従います）。
​
type
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
検索モード。
​
freshness
'day' | 'week' | 'month' | 'year'
時間フィルター。date_after/date_before と組み合わせることはできません。
​
date_after
string
この日付（YYYY-MM-DD）より後の結果。
​
date_before
string
この日付（YYYY-MM-DD）より前の結果。
​
contents
object
コンテンツ抽出オプション（下記参照）。

​
コンテンツ抽出

結果内の抽出コンテンツを制御するには、contents オブジェクトを渡します。 
await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // full page text
    highlights: { numSentences: 3 }, // key sentences
    summary: true, // AI summary
  },
});
コンテンツオプション型説明
textboolean | { maxCharacters }ページ全文を抽出
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }重要な文を抽出
summaryboolean | { query }AI生成の要約
contents を省略した場合、Exaはデフォルトで { highlights: true } になるため、結果には重要文の抜粋が含まれます。結果の説明は、まずハイライト、次に要約、次に全文の順に、最初に利用可能なものから解決されます。利用可能な場合、結果にはExa APIレスポンスの生の highlightScores フィールドと summary フィールドも保持されます。

​
検索モード

モード説明
autoExaが最適なモードを選択（デフォルト）
neuralセマンティック/意味ベースの検索
fast高速なキーワード検索
deep徹底的なディープ検索
deep-reasoning推論を伴うディープ検索
instant最速の結果

​
注記

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

​
関連