Skip to main content

​
Exa 搜尋

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 中。

​
工具參數

參數說明
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 摘要
  },
});
內容選項類型說明
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 欄位
  • 結果說明從重點優先解析，然後是摘要，然後是完整文字 — 無論哪個可用
  • freshness 和 date_after/date_before 無法合併 — 使用一種時間篩選模式
  • 每個查詢最多可返回 100 個結果（受 Exa 搜尋類型限制）
  • 結果預設快取 15 分鐘（可透過 cacheTtlMinutes 設定）
  • Exa 是具有結構化 JSON 回應的官方 API 整合

​
相關