Tavily 搜索与提取工具

概述

Tavily 是专为 AI 应用设计的搜索 API。OpenClaw 以两种方式使用：作为 web_search 提供商，以及作为独立插件工具（tavily_search 和 tavily_extract）。

核心功能

• tavily_search：支持搜索深度（basic/advanced）、主题过滤（general/news/finance）、AI 摘要、时间范围、域名过滤
• tavily_extract：从 URL 提取内容，支持 JS 渲染页面，支持查询聚焦分块（chunks_per_source）
• web_search 提供商：支持 query 和 count（最多 20 条）
• 自动检测优先级：order 70

工具选择指南

需求	工具
快速搜索，无特殊选项	web_search
搜索 + 深度/主题/AI 摘要	tavily_search
从特定 URL 提取内容	tavily_extract

配置/使用

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...",
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: { provider: "tavily" },
    },
  },
}

tavily_extract 关键参数：

• urls：1-20 个 URL
• query：按相关性重排分块（chunks_per_source 需要此参数）
• extract_depth：basic（默认）或 advanced（JS 渲染页面）
• chunks_per_source：1-5，需配合 query 使用

环境变量：TAVILY_API_KEY

注意事项

• chunks_per_source 不能在没有 query 的情况下使用
• advanced 搜索深度更慢但相关性更高
• 批量提取时每次最多 20 个 URL

相关页面

• concepts/tool-web — Web 搜索工具总览
• concepts/tool-firecrawl — Firecrawl（类似的搜索+抓取工具）
• concepts/tool-exa-search — Exa 神经搜索（支持内容提取）