Tools

Exa 搜尋

Exa AI 是一個 web_search 提供者，支援神經、關鍵字及混合搜尋模式，並內建內容擷取功能（重點、文字、摘要）。

安裝外掛

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

取得 API 金鑰

建立帳戶

前往 exa.ai 註冊，並從儀表板產生 API 金鑰。

儲存金鑰

在閘道環境中設定 EXA_API_KEY，或透過以下方式設定：

bash

openclaw configure --section web

設定

json5

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // 如果已設定 EXA_API_KEY，則為選用            baseUrl: "https://api.exa.ai", // 選用；OpenClaw 會附加 /search          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

**環境變數替代方案：**在閘道環境中設定 EXA_API_KEY。若為閘道安裝，請將其放入 ~/.openclaw/.env。請參閱環境變數。

覆寫基礎 URL

設定 plugins.entries.exa.config.webSearch.baseUrl，可讓 Exa 搜尋請求經由相容的代理伺服器或替代端點傳送。OpenClaw 會在未含通訊協定的主機名稱前加上 https:// 以進行正規化，並附加 /search，除非路徑已以該字串結尾。解析後的端點是搜尋快取鍵的一部分，因此不同端點的結果絕不會共用。

工具參數

querystringrequired

搜尋查詢。

countnumberdefault: 5

要傳回的結果數（1–100，受 Exa 搜尋類型限制）。

搜尋模式。

freshness'day' | 'week' | 'month' | 'year'

時間篩選條件。不可與 date_after／date_before 同時使用。

date_afterstring

此日期之後的結果（YYYY-MM-DD）。

date_beforestring

此日期之前的結果（YYYY-MM-DD）。

contentsobject

內容擷取選項（見下文）。

內容擷取

傳入 contents 物件，以控制結果中擷取的內容：

javascript

await web_search({  query: "transformer architecture explained",  type: "neural",  contents: {    text: true, // 完整頁面文字    highlights: { numSentences: 3 }, // 關鍵句子    summary: true, // AI 摘要  },});

內容選項	類型	說明
`text`	`boolean \| { maxCharacters }`	擷取完整頁面文字
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	擷取關鍵句子
`summary`	`boolean \| { query }`	AI 產生的摘要

若省略 contents，Exa 預設使用 { highlights: true }，因此結果會包含關鍵句摘錄。結果說明會依序取自重點、摘要、完整文字，以最先可用者為準。若 Exa API 回應中提供原始 highlightScores 與 summary 欄位，結果也會予以保留。

搜尋模式

模式	說明
`auto`	Exa 選擇最佳模式（預設）
`neural`	以語意／含義為基礎的搜尋
`fast`	快速關鍵字搜尋
`deep`	全面深入搜尋
`deep-reasoning`	結合推理的深入搜尋
`instant`	最快速取得結果

注意事項

count 最多接受 100，並受 Exa 搜尋類型限制。
結果預設快取 15 分鐘。設定共用的 tools.web.search.cacheTtlMinutes（分鐘）及 tools.web.search.timeoutSeconds（預設 30 秒），即可變更所有 web_search 提供者（包括 Exa）的快取和請求逾時設定。