Skills-SafeSkills-Safe

Tavily:好用,但别把搜索结果当结论

给 AI 加上联网搜索能力——方便,但你得知道搜索结果≠正确答案

Skills-Safe 编辑部2026-03-19搜索检索

适合谁

  • 需要让 AI 获取实时网络信息的人(新闻、价格、文档更新)
  • 写报告、做调研时需要 AI 帮忙搜索资料的人
  • 想要 AI 回答"最新情况"而不是停留在训练数据截止日期的人

不适合谁

  • 需要精确数据的场景(学术引用、法律条文、财务数字)——搜索结果不等于事实
  • 需要大规模批量抓取的场景——tavily 不是爬虫工具
  • 完全不在意 API额度消耗的——它是付费 API,滥用会产生费用

3 分钟上手

安装

npx clawhub@latest install tavily

配置

你需要一个 Tavily API Key(免费额度每月 1000 次搜索):

  1. 去 tavily.com 注册账号
  2. 获取 API Key
  3. 在 OpenClaw 设置中配置环境变量

第一次正确使用

试一个简单的实时查询:"今天 OpenAI 有什么新闻?"——确认搜索结果正常返回。然后试一个需要判断的场景:"Tailwind CSS v4 和 v3 的主要区别是什么?"——注意它给出的是搜索摘要,不一定是完整答案。

典型使用场景

场景 1:快速获取实时信息

"这个 npm 包的最新版本是多少?""某某公司最近的融资消息"——适合时效性强、不需要 100% 精确的场景。

场景 2:辅助写作调研

写技术博客或报告时,让 AI 搜索相关资料、竞品信息、行业趋势——作为参考素材,而不是直接引用。

场景 3:对比多个信息源

"帮我搜索 3 个不同来源对这个话题的看法"——tavily 会返回多条结果,你可以让 AI 交叉比对。

常见翻车点

  • 把搜索摘要当事实:tavily 返回的是网页摘要,可能断章取义或信息过时
  • API 额度不知不觉用完:每次搜索消耗一次 API 调用,连续对话中 AI 可能自动多次搜索
  • 搜索质量依赖查询词:AI 生成的搜索词不一定是最优的,有时需要你手动调整
  • 中文搜索效果偏弱:tavily 的英文搜索质量明显优于中文

风险提示

权限风险

  • 低权限:只需要网络访问进行搜索,不涉及文件系统或 Shell
  • 外部 API 依赖:数据经由 Tavily 服务器,非本地处理

使用风险

  • 搜索结果 ≠ 最终结论:最常见的误用是不经验证就采信搜索结果
  • 付费 API 额度消耗:免费额度有限,长对话中容易超额
  • 判断风险:在需要高准确性的场景,tavily 提供的"方便"可能导致错误的信心

建议

  • 把 tavily 搜索结果当"线索"而不是"答案"
  • 重要信息务必人工验证原始来源
  • 关注每月 API 用量,避免意外超额

相关替代技能

  • agent-browser:如果你需要访问特定网页并提取精确内容(而不是搜索摘要),agent-browser 更精确但更复杂
  • fetch(内置):如果你已经知道目标 URL,直接 fetch 更简单
  • summarize:如果你要处理的是已有内容的摘要,而不是联网搜索新内容