​

Tavily

• 作為 web_search 提供者
• 作為明確外掛工具：tavily_search 和 tavily_extract

​

取得 API 金鑰

1. 在 tavily.com 建立 Tavily 帳戶。
2. 在儀表板中產生 API 金鑰。
3. 在設定中儲存它或在 gateway 環境中設定 TAVILY_API_KEY。

​

設定 Tavily 搜尋

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // 如果設定了 TAVILY_API_KEY 則選用
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}

• 在入職中選擇 Tavily 或 openclaw configure --section web 會自動啟用捆綁的 Tavily 外掛。
• 在 plugins.entries.tavily.config.webSearch.* 下儲存 Tavily 設定。
• web_search 與 Tavily 支援 query 和 count（最多 20 個結果）。
• 對於 Tavily 特定控制如 search_depth、topic、include_answer 或領域篩選，請使用 tavily_search。

​

Tavily 外掛工具

​

tavily_search

​

tavily_extract

• 每個請求最多 20 個 URL。將較大清單分成多個呼叫。
• 使用 query + chunks_per_source 只取得相關內容，而非完整頁面。
• 先試試 basic；如果內容遺失或不完整，則改為 advanced。

​

選擇正確的工具

​

相關

• 網路搜尋概觀 — 所有提供者和自動偵測
• Firecrawl — 搜尋 + 抓取與內容擷取
• Exa 搜尋 — 神經搜尋與內容擷取