Tavily

OpenClaw 以两种方式使用 Tavily：

作为 web_search 提供商
作为显式插件工具：tavily_search 和 tavily_extract

Tavily 是一个专为 AI 应用设计的搜索 API，返回针对 LLM 消费优化的结构化结果。它支持可配置的搜索深度、主题过滤、域名过滤、AI 生成的答案摘要，以及从 URL（包括 JavaScript 渲染页面）提取内容。

获取 API Key

在 tavily.com 创建 Tavily 账户。
在控制台生成 API Key。
将其存储在配置中，或在网关环境中设置 TAVILY_API_KEY。

配置 Tavily 搜索

json5

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // 若已设置 TAVILY_API_KEY 可省略
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}

注意：

在引导程序或 openclaw configure --section web 中选择 Tavily 会自动启用捆绑的 Tavily 插件。
将 Tavily 配置存储在 plugins.entries.tavily.config.webSearch.* 下。
使用 Tavily 的 web_search 支持 query 和 count（最多 20 个结果）。
对于 Tavily 特有的控制选项，如 search_depth、topic、include_answer 或域名过滤，使用 tavily_search。

Tavily 插件工具

`tavily_search`

当你需要 Tavily 特有的搜索控制而非通用 web_search 时使用。

参数	描述
`query`	搜索查询字符串（保持在 400 字符以内）
`search_depth`	`basic`（默认，均衡）或 `advanced`（最高相关性，较慢）
`topic`	`general`（默认）、`news`（实时更新）或 `finance`
`max_results`	结果数量，1-20（默认：5）
`include_answer`	包含 AI 生成的答案摘要（默认：false）
`time_range`	按时效过滤：`day`、`week`、`month` 或 `year`
`include_domains`	限制结果的域名数组
`exclude_domains`	从结果中排除的域名数组

搜索深度：

深度	速度	相关性	最适合
`basic`	较快	高	通用查询（默认）
`advanced`	较慢	最高	精确查询、特定事实、深度研究

`tavily_extract`

用于从一个或多个 URL 提取干净内容。处理 JavaScript 渲染页面，支持以查询为中心的分块以实现精准提取。

参数	描述
`urls`	要提取的 URL 数组（每次请求 1-20 个）
`query`	按与此查询的相关性重排提取的分块
`extract_depth`	`basic`（默认，快速）或 `advanced`（适用于 JS 密集页）
`chunks_per_source`	每 URL 的分块数，1-5（需要 `query`）
`include_images`	在结果中包含图片 URL（默认：false）

提取深度：

深度	使用时机
`basic`	简单页面——先试这个
`advanced`	JS 渲染的 SPA、动态内容、表格

提示：

每次请求最多 20 个 URL。较大的列表分多次调用批处理。
使用 query + chunks_per_source 只获取相关内容，而非完整页面。
先尝试 basic；若内容缺失或不完整则回退到 advanced。

选择合适的工具

需求	工具
快速网页搜索，无特殊选项	`web_search`
带深度、主题、AI 答案的搜索	`tavily_search`
从特定 URL 提取内容	`tavily_extract`

Tavily ​

获取 API Key ​

配置 Tavily 搜索 ​

Tavily 插件工具 ​

tavily_search ​

tavily_extract ​

选择合适的工具 ​

相关链接 ​