Exa 搜尋

OpenClaw 支援將 Exa AI 作為 web_search 提供者。Exa 提供神經、關鍵字和混合搜尋模式，並內建內容提取功能（亮點、文字、摘要）。

取得 API 金鑰

建立帳號

在 [exa.ai](https://exa.ai/) 註冊，並從您的儀表板

產生 API 金鑰。

儲存金鑰
在 Gateway 環境中設定 EXA_API_KEY，或透過以下方式設定：
Terminal window
```
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 中。

基礎 URL 覆寫

當 Exa 搜尋請求應透過相容的代理或替代 Exa 端點發送時，設定 plugins.entries.exa.config.webSearch.baseUrl。OpenClaw 會透過在前面加上 https:// 並在後面附加 /search 來正規化裸主機，除非路徑已經在那裡結束。解析後的端點包含在搜尋快取金鑰中，因此來自不同 Exa 端點的結果不會共用。

工具參數

搜尋查詢。要傳回的結果數（1–100）。搜尋模式。時間篩選器。此日期之後的結果（`YYYY-MM-DD`）。此日期之前的結果（`YYYY-MM-DD`）。內容提取選項（見下文）。

內容提取

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
  },
});

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 欄位
結果描述優先從 highlights 解析，其次是 summary，然後是 full text —— 取決於何者可用
freshness 和 date_after/date_before 不能組合使用 —— 請使用一種時間篩選模式
每次查詢最多可傳回 100 個結果（受 Exa 搜尋類型限制）
結果預設快取 15 分鐘（可透過 cacheTtlMinutes 設定）
Exa 是具有結構化 JSON 回應的官方 API 整合