メインコンテンツへスキップ

​
Exa Search

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

​
API キーを取得する

1

アカウントを作成

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

キーを保存

Gateway 環境で EXA_API_KEY を設定するか、次を使って設定します:
openclaw configure --section web

​
設定

{
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // EXA_API_KEY が設定されていれば省略可
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}
環境変数の代替方法: Gateway 環境で EXA_API_KEY を設定します。 gateway インストールでは、これを ~/.openclaw/.env に置きます。

​
ツールパラメーター

Parameter説明
query検索クエリ（必須）
count返す結果数（1〜100）
type検索モード: auto、neural、fast、deep、deep-reasoning、または instant
freshness時間フィルター: day、week、month、または year
date_afterこの日付以降の結果（YYYY-MM-DD）
date_beforeこの日付以前の結果（YYYY-MM-DD）
contentsコンテンツ抽出オプション（下記参照）

​
コンテンツ抽出

Exa は、検索結果とあわせて抽出済みコンテンツを返すことができます。有効にするには contents オブジェクトを渡します。 
await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // ページ全文テキスト
    highlights: { numSentences: 3 }, // 重要な文
    summary: true, // AI 要約
  },
});
Contents optionType説明
textboolean | { maxCharacters }ページ全文を抽出
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }重要な文を抽出
summaryboolean | { query }AI 生成の要約

​
検索モード

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

​
メモ

  • contents オプションが指定されていない場合、Exa のデフォルトは { highlights: true } となり、結果に重要文の抜粋が含まれます
  • 利用可能な場合、結果には Exa API レスポンスの highlightScores と summary フィールドが保持されます
  • 結果の説明は、利用可能なものに応じて、まず highlights、次に summary、 最後に全文テキストから解決されます
  • freshness と date_after/date_before は併用できません。時間フィルターは いずれか 1 つのモードを使ってください
  • クエリごとに最大 100 件の結果を返せます（Exa の検索タイプ 制限に従います）
  • 結果はデフォルトで 15 分間キャッシュされます（cacheTtlMinutes で設定可能）
  • Exa は、構造化 JSON レスポンスを持つ公式 API 統合です

​
関連