Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 可以通过两种方式使用 Tavily：
  • 作为 web_search 提供方
  • 作为显式插件工具：tavily_search 和 tavily_extract
Tavily 是专为 AI 应用设计的搜索 API，会返回经过结构化处理的结果， 并针对 LLM 消费进行了优化。它支持可配置的搜索深度、主题 筛选、域名过滤、AI 生成的答案摘要，以及从 URL 中提取内容 （包括 JavaScript 渲染页面）。

​
获取 API 密钥

  1. 在 tavily.com 创建 Tavily 账号。
  2. 在控制台中生成 API 密钥。
  3. 将其存储在配置中，或在网关环境中设置 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",
      },
    },
  },
}
注意：
  • 在 onboarding 中选择 Tavily，或运行 openclaw configure --section web，会自动启用 内置的 Tavily 插件。
  • 将 Tavily 配置存放在 plugins.entries.tavily.config.webSearch.* 下。
  • 使用 Tavily 的 web_search 支持 query 和 count（最多 20 条结果）。
  • 对于 Tavily 特有的控制项，如 search_depth、topic、include_answer 或域名过滤器，请使用 tavily_search。

​
Tavily 插件工具

当你需要 Tavily 特有的搜索控制项，而不是通用的 web_search 时，请使用它。
参数描述
query搜索查询字符串（保持在 400 个字符以内）
search_depthbasic（默认，平衡）或 advanced（最高相关性，较慢）
topicgeneral（默认）、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_depthbasic（默认，快速）或 advanced（适用于 JS 密集型页面）
chunks_per_source每个 URL 的块数，1-5（需要 query）
include_images在结果中包含图片 URL（默认：false）
提取深度：
深度何时使用
basic简单页面——先尝试这个
advancedJS 渲染的 SPA、动态内容、表格
提示：
  • 每次请求最多 20 个 URL。更大的列表请分批拆分为多个调用。
  • 使用 query + chunks_per_source 只获取相关内容，而不是完整页面。
  • 先尝试 basic；如果内容缺失或不完整，再回退到 advanced。

​
选择合适的工具

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

​
相关内容