适合谁
- 需要让 AI 获取实时网络信息的人(新闻、价格、文档更新)
- 写报告、做调研时需要 AI 帮忙搜索资料的人
- 想要 AI 回答"最新情况"而不是停留在训练数据截止日期的人
不适合谁
- 需要精确数据的场景(学术引用、法律条文、财务数字)——搜索结果不等于事实
- 需要大规模批量抓取的场景——tavily 不是爬虫工具
- 完全不在意 API额度消耗的——它是付费 API,滥用会产生费用
3 分钟上手
安装
npx clawhub@latest install tavily
配置
你需要一个 Tavily API Key(免费额度每月 1000 次搜索):
- 去 tavily.com 注册账号
- 获取 API Key
- 在 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:如果你要处理的是已有内容的摘要,而不是联网搜索新内容