🌐 Tavily Web Search

信息检索 · 数据聚合 · 搜索引擎

专为大模型智能体优化特调的商用级检擎管道。通过 Tavily API 的底层调用，从全网获取无冗余结构化的优质数据流，打破大模型的孤岛训练周期限制。

OpenClaw Team

🚀 快速安装

在您的终端中执行以下命令即可完成安装：

npx clawhub install tavily-search

📊 数据总览

⭐ 收藏点赞	☁️ 总计下载	👥 当前活跃	🎯 稳定版本
821	94.5k	2,110	v1.2.0

🎛️ 详解：它是如何运转的？

普通的网络请求或是单纯的 Google 抓取由于包含海量的广告信息和嵌套杂乱无章的 DOM 元素，AI 在阅读时难以提取信息甚至会爆发极高的 Token 耗竭成本。而基于专门架构适配的 Tavily 整合：

🔍 AI 驱动网页搜索范式：调用业界标杆的 Tavily API。它不仅是个查询组件，在网络层还加入了清洗节点，向本地返回包含上下文的高维极简 JSON 树组。
📝 精准全文提取剔除：直接从匹配结果网页中暴力剥离所有的反爬组件与侧边推流广告，将文章、报告等关键正文一键投喂到本地大语言模型的上下文缓存器中。
🛡️ 域名精准化白盒过滤：使用附带的命令管道强硬限制结果源（include-domains / exclude-domains），防止模型摄入不合规或是严重偏颇维基站点。
🚀 搜索模式智能升降维：内建针对不同算力配比的模式切换。可使用 basic 抢占高速带宽资源，亦或启用 advanced 烧录更长的执行链深入冰柜层网络挖掘晦涩资源。

🧭 典型业务场景剖析

📑 场景一：深空投研数据获取

当用户提问："请帮我深度分析一下昨天刚刚发布的 Apple Vision Pro 的市场评价综合反响，并剔除营销号。" 智能体会随即接驳该插件的 advanced 深度模式与 topic news（强新闻资讯面检索）频道。组件可以自动避开所有不相关的干扰词条，跨越多个知名科技新闻源，整合出包含具体评论段落的结构数据矩阵报告给主脑节点进行分析。

🚨 场景二：开发依赖实盘排错

假如模型遇到一个最新版本库（比如 Next.js 14 的突发边缘 Bug），自身模型权重内部因为知识断档而缺乏解法。借助智能体的动态反思机制，模型会借由 Tavily 的特搜渠道定点查询 exclude-domains stackoverflow.com（排除已知泛滥解答区，寻找官方声音），转而直接扫描官方 Issue 追踪器和最新提交的 Commit 注释，以提取未经污染的第一手修复方法。

💻 常用命令参考

安装完成后，您不仅可以通过对话让 AI 自主调用，还可以在 CLI 侧手动发起操作：

执行强导向新闻热源查询，并划界深海模式及结果阈值：

clawhub execute tavily-search --topic news --max-results 10 "Latest AI policy regulations in EU"

开启定向域名的严格限制范围圈定：

clawhub execute tavily-search --include-domains "github.com, arxiv.org" "Transformer mathematical explanation"

切换为高速轻量的 basic 架构：

clawhub execute tavily-search advanced=false "Local weather mechanism in Tokyo"

🛡️ 环境要求与鉴权预备

🔑 Tavily 内核 API KEY 主机注入：在使用前除了需要通过 npx 装包外，还必须注册 tavily.com 从而获取免费额度或商业授权的密钥身份。您需要在执行唤醒 Agent 之前预混环境变量：export TAVILY_API_KEY="tvly-xxxxxxxxxxxx"。
💰 流量封顶：请在云端服务侧设置硬性上限，防范由于大模型死循环调度引发的海量查询账单。

🔗 查看 GitHub 源代码