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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

API キーを取得する

1

アカウントを作成する

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

キーを保存する

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

ツールパラメーター

query
string
必須
検索クエリ。
count
number
返す結果数(1–100)。
type
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
検索モード。
freshness
'day' | 'week' | 'month' | 'year'
時間フィルター。
date_after
string
この日付(YYYY-MM-DD)より後の結果。
date_before
string
この日付(YYYY-MM-DD)より前の結果。
contents
object
コンテンツ抽出オプション(以下を参照)。

コンテンツ抽出

Exa は、検索結果とともに抽出済みコンテンツを返せます。有効にするには 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 生成の要約

検索モード

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

注記

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

関連