前言¶
让大模型回答实时问题时，常见的做法是接一套搜索 API，自己处理抓取、清洗、引用。这样能跑通，但每一步都要写胶水代码，而且结果格式往往不适合直接喂给模型。
下面介绍的 Tavily Search 把这套流程封装成一个 Agent Skill：一条命令完成安装，一条命令完成搜索，返回结构化结果，自带来源引用。它适合需要在对话或 Agent 流程里做联网检索的开发者。
这是什么¶
Tavily Search 是 Tavily AI 搜索工具的 Skill 封装，为 AI Agent 提供联网搜索能力，支持实时搜索、深度研究、图片搜索和引用生成，返回结构化搜索结果。
- 出品方：由开发者 paudyyin 发布，上游仓库在 ClawHub（坐标 @clawhub_paudyyin/tavily-search），当前版本 1.0.0。
- 来源：clawhub，分类为 knowledge-management，License 为 MIT-0。
- 标签 requires_api_key=true，使用前需要先配置 Tavily API 密钥。
- 在 SkillHub 上的评分为 100000，下载 107913 次，安装 1855 次。
一句话定位：它把「调搜索 API + 解析结果」这件事变成一次 CLI 调用。
核心功能¶
官方资料列出四项能力，都是已核实的功能。
1、基础搜索。快速获取实时搜索结果，返回标题、摘要、来源 URL、发布时间。支持最新资讯、热点事件查询和事实类问题，自动过滤低质量与广告内容。
2、深度搜索（Research Mode）。针对复杂问题做多网页整合分析：自动检索多个相关网页，整合内容生成结构化研究报告，保留所有来源引用，最多提取 50 个页面内容。
3、图片搜索。返回与关键词相关的高清图片 URL，支持多关键词组合，自动过滤违规或低质量图片，返回可直接访问的链接。
4、搜索结果分析。自动提取搜索结果中的核心信息，包括关键点摘要、时间线整理、多方观点对比和数据/事实统计。
安装与启用¶
上游 ClawHub 页面给出的安装方式如下，这是 OpenClaw 生态的 skills 安装命令：
$ openclaw skills install @paudyyin/tavily-search
页面同时提到 CLI 为 npx skills，即也可以通过 npx 方式安装。
安装完成后需要配置 API 密钥。先到 Tavily 官网注册账号，免费版每月提供 1000 次搜索请求；然后在本地执行：
tavily config --api-key tvly-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
配置会自动保存到 config.json 文件中，无需重复配置。
关于 Cursor、Codex CLI、Claude Code 的差异：上游资料只给出了 OpenClaw 的安装命令和通用的 tavily CLI，没有说明这几种工具各自的启用方式，所以这里不做推断。该 Skill 基于通用 SKILL.md 格式，实际能否在这些编辑器里直接调用，需要各自查阅其 Skill 支持文档。
另外，SkillHub 上的这一分发版本标注为按次计费技能（0.01 元/次）：执行核心任务会触发一次平台支付授权，是否执行付费动作由用户决定。授权由作者自有服务 pay.sharpdealhub.com 承载，不是第三方支付网关，仅接收动作名与订单号，不读取本技能处理的内容。
典型用法¶
以下示例来自上游 ClawHub 页面，可直接复现。
基础搜索：
tavily search "2026年AI大模型最新进展"
深度研究，用 --max-pages 控制抓取页面数量：
tavily research "企业AI安全建设方案" --max-pages 10
图片搜索，用 --count 控制返回数量：
tavily image "2026年新款AI硬件产品" --count 5
需要把结果交给程序处理时，用 --format json 输出结构化 JSON：
tavily search "OpenClaw最新版本" --format json
返回的 JSON 包含 query、answer、results（每项含 title、url、content、published_date）、images 和 response_time。其中 answer 字段是生成的自然语言答案。
API 参数说明¶
以下参数表来自上游资料，默认值即不带额外参数时的取值。
| 参数 | 说明 | 默认值 |
|---|---|---|
| query | 搜索关键词 | 必填 |
| search_depth | 搜索深度：basic / advanced | basic |
| max_results | 返回结果数量 | 5 |
| include_images | 是否返回图片 | false |
| include_answer | 是否生成自然语言答案 | true |
| include_raw_content | 是否返回网页原始内容 | false |
| domain | 限定搜索域名（可选） | 无 |
实际使用中，include_answer 默认为 true，如果只需要原始结果列表，把它关掉可以减少一次生成。
适用场景与注意¶
适合的场景：
- Agent 流程中需要实时信息、事实核查或热点追踪。
- 需要带来源引用的检索结果，便于溯源和验证。
- 需要把搜索结果直接作为结构化数据交给下游程序处理。
限制与坑：
- 必须有 Tavily API 密钥才能用，免费版每月 1000 次搜索请求，超出需要付费。
- 深度搜索模式最多提取 50 个页面，复杂问题仍然受这个上限约束。
- 触发词包括 tavily-search、gemini、valyu，只适用于网页搜索相关请求；与网页搜索无关的请求不应使用本技能。
- SkillHub 分发版本的每次执行会触发 0.01 元的平台支付授权，由用户自行决定是否执行付费动作。
- 上游 ClawHub 显示该技能最近更新于 4 个月前，改动前先确认是否仍满足需求。
结尾¶
Tavily Search 的价值在于把联网搜索的接入成本压到一条命令：装完、配好密钥、调用即可，返回的是带引用的结构化结果。如果只是想让 Agent 具备实时检索能力，而不想自己维护抓取和解析逻辑，这是一个可以直接上手的选项。
官方地址：https://api.skillhub.cn/org-pqka8yp5/tavily-search（上游仓库：https://clawhub.ai/paudyyin/tavily-search）
