OpenClaw Tavily Web Search 技能指南

OpenClaw Tavily Web Search 技能概述

Tavily Web Search 技能将 OpenClaw 连接到 Tavily Search API，这是一个专为 AI 智能体和 LLM 应用打造的 AI 优化搜索引擎。与返回原始链接的传统搜索 API 不同，Tavily 会分析多个来源并返回结构化的相关内容，供你的 OpenClaw 智能体直接使用。

Tavily 为超过 100 万名开发者提供搜索服务，每月处理超过 1 亿次请求。它受到 OpenAI、Anthropic、LangChain 等领先 AI 平台的信赖。凭借 SOC 2 认证、零数据留存策略和内置的提示注入防护，Tavily 是为你的智能体提供网页访问能力的最安全方式之一。

典型工作流：

1. 向 OpenClaw 提出一个需要最新信息的问题。
2. 智能体使用优化后的查询调用 Tavily API。
3. Tavily 搜索网页，从多个来源提取相关内容，并在 2 秒内返回带有引用的结构化摘要。

该技能非常适合研究任务、事实核查、时事查询以及任何需要智能体访问训练数据之外信息的工作流。它可以与 Brave Search 技能搭配使用以满足隐私导向的查询需求，也可以与 DeepWiki 技能搭配进行代码仓库文档研究。

Tavily Web Search 技能安装前的准备

安装 Tavily Web Search 技能之前，请确保你具备以下条件：

• OpenClaw 已安装并运行（v1.0+）
• 一个 Tavily API 密钥 — 在 tavily.com 注册（免费版每月包含 1,000 个额度）
• 已安装 clawhub CLI 用于技能管理

验证你的环境：

# 检查 OpenClaw 版本
openclaw --version

# 确认 Tavily API 密钥已设置
echo $TAVILY_API_KEY

无需安装额外软件。该技能与 Tavily 的云端 API 通信，除 OpenClaw 本身外没有其他本地依赖。

如何安装 Tavily Web Search 技能

使用一条命令安装 Tavily Web Search 技能：

npx clawhub@latest install tavily-web-search

验证安装：

clawhub list

你应该能在已安装技能列表中看到 tavily-web-search。

Tavily Web Search 技能配置指南

该技能需要 Tavily API 密钥进行身份验证。你可以在 app.tavily.com 获取免费密钥。

API 密钥设置

# 将 Tavily API 密钥设置为环境变量
export TAVILY_API_KEY=tvly-your-api-key-here

要使此设置永久生效，请将 export 行添加到你的 Shell 配置文件（~/.bashrc、~/.zshrc 或等效文件）中。

搜索模式

该技能支持两种搜索深度和两种主题模式，你可以根据需求灵活组合：

| 模式 | 速度 | 覆盖范围 | 适用场景 | |------|------|---------|---------| | 基础模式 | 1-2 秒 | 良好 | 快速查询事实、简单搜索 | | 高级模式 | 5-10 秒 | 出色 | 复杂研究、全面回答 |

| 主题 | 范围 | 适用场景 | |------|------|---------| | 通用 | 全时段网页内容 | 长期有效的主题、文档、教程 | | 新闻 | 最近 7 天，新闻来源 | 时事热点、突发新闻、市场动态 |

智能体会根据你的查询自动选择合适的模式，但你也可以在提示词中指定"做一次深度搜索"或"搜索最新新闻"来覆盖默认选择。

重要提示： 切勿将 API 密钥硬编码到配置文件中或提交到版本控制系统。请使用环境变量或密钥管理器，例如 1Password。

Tavily Web Search 技能使用示例

1. 快速事实查询

你： "Next.js 最新的稳定版本是多少？"

智能体执行基础 Tavily 搜索，从官方来源提取版本号，并返回带有 Next.js 发布说明链接的简洁答案。

2. 深度研究

你： "对比电商网站使用服务端渲染和静态站点生成的优缺点。"

智能体执行高级搜索，从多篇博客文章、文档页面和案例研究中汇总见解，并返回带有每个观点引用来源的结构化对比。

3. 时事与新闻

你： "本周 AI 行业发生了什么？"

智能体切换到新闻模式，搜索最近 7 天的内容，并返回顶级 AI 新闻报道的摘要及原文链接。

4. 特定域名研究

你： "只搜索 MDN 和 TypeScript 文档，查找如何使用模板字面量类型。"

智能体使用域名过滤功能，仅包含 developer.mozilla.org 和 typescriptlang.org，确保结果完全来自权威来源。

5. 内容提取

你： "提取 Tavily API 定价页面的完整内容并总结各个套餐。"

智能体使用原始内容提取功能获取完整页面内容，然后生成每个定价套餐的结构化分析，包含功能和限制说明。

安全与最佳实践

使用 Tavily Web Search 技能时，请遵循以下指南：

• 保护好你的 API 密钥。 将其存储在环境变量或密钥管理器中。切勿在聊天记录中分享、提交到 Git 或在客户端代码中暴露。
• 将搜索结果视为不可信输入。 网页内容可能包含不准确、过时或被篡改的信息。在采取行动之前，务必从多个来源验证关键事实。查看安全检查清单了解通用指南。
• 监控你的用量。 免费版每月提供 1,000 个额度。每次基础搜索消耗 1 个额度，高级搜索消耗 2 个额度。在 app.tavily.com 查看用量以避免意外超额。
• 敏感查询使用域名过滤。 当准确性至关重要时，使用包含域名过滤器将结果限制在可信域名（官方文档、政府网站、知名出版物）。
• 注意速率限制。 避免在循环中快速连续发送查询。该技能会优雅地处理速率限制，但过多的请求可能会临时节流你的访问。

常见错误与故障排除

"Invalid API key"

你的 Tavily API 密钥缺失、格式错误或已过期。

1. 验证密钥已设置：echo $TAVILY_API_KEY
2. 确保密钥以 tvly- 开头——Tavily 的密钥始终使用此前缀。
3. 如果密钥正确但仍然失败，请在 app.tavily.com 生成一个新密钥。

"Rate limit exceeded"

你已超出当前套餐的请求限额。

1. 在 app.tavily.com 查看当前用量。
2. 如果你使用的是免费版，请等待下月 1 日的月度重置。
3. 考虑升级到付费套餐以获取更高限额，或优化查询，在不需要高级模式的场景下使用基础模式。

"No results found"

查询未返回匹配结果。这在非常小众或高度特定的搜索中可能发生。

1. 扩大搜索范围——移除过于具体的过滤条件。
2. 如果使用了域名过滤，请确保目标域名确实包含相关内容。
3. 如果搜索的主题不是近期事件，尝试从新闻模式切换到通用模式。