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. 如果搜索的主题不是近期事件，尝试从新闻模式切换到通用模式。