Tools
Tavily
Tavily 是專為 AI 應用程式設計的搜尋 API。OpenClaw 透過兩種方式提供此功能：
- 作為通用搜尋工具的
web_search提供者 - 作為明確的外掛工具：
tavily_search和tavily_extract
Tavily 會傳回針對 LLM 使用情境最佳化的結構化結果，並提供可設定的搜尋深度、主題篩選、網域篩選、AI 產生的答案摘要，以及從 URL 擷取內容的功能（包括透過 JavaScript 轉譯的頁面）。
| 屬性 | 值 |
|---|---|
| 外掛 ID | tavily |
| 套件 | @openclaw/tavily-plugin |
| 驗證 | TAVILY_API_KEY 環境變數或設定 apiKey |
| 基礎 URL | https://api.tavily.com（預設）；使用 TAVILY_BASE_URL 環境變數或設定 baseUrl 覆寫 |
| 逾時 | 搜尋 30 秒、擷取 60 秒（預設） |
| 工具 | tavily_search、tavily_extract |
開始使用
安裝外掛
openclaw plugins install @openclaw/tavily-plugin取得 API 金鑰
在 tavily.com 建立 Tavily 帳戶，然後在儀表板中產生 API 金鑰。
設定外掛和提供者
{ plugins: { entries: { tavily: { enabled: true, config: { webSearch: { apiKey: "tvly-...", // 若已設定 TAVILY_API_KEY，則為選用 baseUrl: "https://api.tavily.com", }, }, }, }, }, tools: { web: { search: { provider: "tavily", }, }, },}確認搜尋可正常執行
從任何代理程式觸發 web_search，或直接呼叫 tavily_search。
工具參考
tavily_search
若要使用 Tavily 專屬的搜尋控制項，而非通用的 web_search，請使用此工具。
| 參數 | 類型 | 限制／預設值 | 說明 |
|---|---|---|---|
query |
字串 | 必填 | 搜尋查詢字串。 |
search_depth |
列舉 | basic（預設）、advanced |
advanced 較慢，但相關性更高。 |
topic |
列舉 | general（預設）、news、finance |
依主題類別篩選。 |
max_results |
整數 | 1-20，預設 5 |
結果數量。 |
include_answer |
布林值 | 預設 false |
包含 Tavily AI 產生的答案摘要。 |
time_range |
列舉 | day、week、month、year |
依時效性篩選結果。 |
include_domains |
字串陣列 | （無） | 僅包含來自這些網域的結果。 |
exclude_domains |
字串陣列 | （無） | 排除來自這些網域的結果。 |
搜尋深度的取捨：
| 深度 | 速度 | 相關性 | 最適合的用途 |
|---|---|---|---|
basic |
較快 | 高 | 一般用途查詢（預設）。 |
advanced |
較慢 | 最高 | 精準研究和事實查證。 |
tavily_extract
使用此工具可從一個或多個 URL 擷取乾淨的內容。它能處理由 JavaScript 轉譯的頁面，並支援以查詢為重點的分塊，以便進行目標式擷取。
| 參數 | 類型 | 限制／預設值 | 說明 |
|---|---|---|---|
urls |
字串陣列 | 必填，1-20 | 要從中擷取內容的 URL。 |
query |
字串 | （選用） | 依與此查詢的相關性重新排序擷取的區塊。 |
extract_depth |
列舉 | basic（預設）、advanced |
對大量使用 JS 的頁面、SPA 或動態表格使用 advanced。 |
chunks_per_source |
整數 | 1-5；需要 query |
每個 URL 傳回的區塊數。若未設定 query 就使用此參數，會發生錯誤。 |
include_images |
布林值 | 預設 false |
在結果中包含圖片 URL。 |
擷取深度的取捨：
| 深度 | 使用時機 |
|---|---|
basic |
簡單頁面。請先嘗試此選項。 |
advanced |
由 JS 轉譯的 SPA、動態內容、表格。 |
選擇合適的工具
| 需求 | 工具 |
|---|---|
| 快速網頁搜尋，不需要特殊選項 | web_search |
| 使用深度、主題和 AI 答案進行搜尋 | tavily_search |
| 從特定 URL 擷取內容 | tavily_extract |
進階設定
API 金鑰解析順序
Tavily 用戶端會依照以下順序尋找其 API 金鑰：
plugins.entries.tavily.config.webSearch.apiKey（透過 SecretRefs 解析）。- 來自閘道環境的
TAVILY_API_KEY。
如果兩者皆不存在，tavily_search 和 tavily_extract 都會引發設定錯誤。
自訂基礎 URL
如果透過 Proxy 連接 Tavily，請覆寫 plugins.entries.tavily.config.webSearch.baseUrl，或設定 TAVILY_BASE_URL。設定的優先順序高於環境變數。預設值為 https://api.tavily.com。
`chunks_per_source` 需要 `query`
tavily_extract 會拒絕傳入 chunks_per_source 卻未傳入 query 的呼叫。Tavily 會依照與查詢的相關性對區塊進行排序，因此若沒有查詢，此參數便毫無意義。
相關內容
Was this useful?
