🔍 Tavily Search 技能

💡 技能类型: 网络搜索 | 难度: 简单 | 需要 API: 是

技能简介

Tavily Search 是一个专为大语言模型（LLM）和 AI 应用优化的搜索引擎技能。与传统搜索 API 不同，Tavily 提供 AI 就绪的搜索结果，包含内容摘要、相关性评分和丰富的元数据，让 OpenClaw 能够快速获取网络信息并做出智能决策。

核心特性

  • AI 优化结果 — 返回经过优化的搜索结果，适合 LLM 直接处理
  • 内容摘要 — 自动提取关键内容片段，无需完整爬取网页
  • 相关性评分 — 每个结果都带有相关性分数，帮助筛选最佳答案
  • 域名过滤 — 支持指定或排除特定域名的搜索结果
  • 搜索深度控制 — 支持基础（basic）和高级（advanced）两种搜索深度
  • 快速响应 — 针对 AI 应用场景优化，响应速度快

下载安装

方式一：通过 ClawHub 安装（推荐）

访问 ClawHub 技能市场下载：

链接
https://clawhub.ai/arun-8687/tavily-search

在 ClawHub 页面点击 Download 按钮，下载技能包。

方式二：通过命令行安装

bash
# 使用 OpenClaw CLI 安装
openclaw skills install tavily-search

# 或者使用 npx
npx openclaw skills add arun-8687/tavily-search

方式三：手动安装

  1. 从 ClawHub 下载技能包（ZIP 文件）
  2. 解压到 OpenClaw 的 skills 目录：~/.openclaw/skills/tavily-search/
  3. 重启 OpenClaw 服务

配置方法

1. 获取 Tavily API Key

首先需要在 Tavily 官网注册并获取 API Key：

  1. 访问 Tavily 官网
  2. 注册账号并登录
  3. 在控制台中创建 API Key
  4. 复制 API Key（格式类似：tvly-xxxxxxxxxxxxxx）

💡 提示: Tavily 提供免费额度，每月可免费调用 1000 次搜索。

2. 配置环境变量

在 OpenClaw 的 .env 文件中添加 Tavily API Key：

bash
# Tavily Search API
TAVILY_API_KEY=tvly-your-api-key-here

3. 配置技能参数（可选）

编辑技能配置文件 ~/.openclaw/skills/tavily-search/config.yaml：

yaml
# Tavily Search 配置
enable: true
api_key: ${TAVILY_API_KEY}  # 从环境变量读取

# 默认搜索参数
defaults:
  max_results: 5              # 最大返回结果数
  search_depth: "basic"       # 搜索深度: basic | advanced
  include_answer: true        # 是否包含 AI 生成的答案
  include_raw_content: false  # 是否包含原始网页内容
  include_images: false       # 是否包含图片链接

# 域名过滤（可选）
# include_domains:
#   - "wikipedia.org"
#   - "github.com"
# exclude_domains:
#   - "example.com"

4. 重启 OpenClaw

bash
openclaw restart

使用方法

在对话中使用

配置完成后，OpenClaw 会自动在需要时调用 Tavily Search 技能。你可以直接向 OpenClaw 提问：

示例对话
用户: 帮我搜索一下 2026 年最新的 AI 技术趋势
OpenClaw: [自动调用 Tavily Search] 正在搜索...

用户: OpenClaw 的最新版本有哪些新特性？
OpenClaw: [自动调用 Tavily Search] 让我为你查找最新信息...

通过 CLI 直接调用

也可以通过命令行直接测试技能：

bash
# 基础搜索
openclaw skill run tavily-search --query "OpenClaw 教程"

# 指定最大结果数
openclaw skill run tavily-search --query "AI 助手" --max-results 10

# 高级搜索（更深入）
openclaw skill run tavily-search --query "机器学习" --search-depth advanced

# 过滤域名
openclaw skill run tavily-search --query "Python" --include-domains "github.com,stackoverflow.com"

在代码中调用

javascript
// 在 OpenClaw 技能或插件中调用
const result = await openclaw.skills.call('tavily-search', {
  query: 'OpenClaw 最新版本',
  max_results: 5,
  search_depth: 'basic'
});

console.log(result.answer);  // AI 生成的答案
console.log(result.results); // 搜索结果列表

使用示例

示例 1：快速信息查询

对话
用户: 今天北京的天气怎么样？
OpenClaw: [调用 Tavily Search]
根据最新信息，北京今天晴，气温 15-25°C，空气质量良好。

示例 2：技术问题解答

对话
用户: 如何在 Node.js 中使用 async/await？
OpenClaw: [调用 Tavily Search]
async/await 是 JavaScript 中处理异步操作的语法糖...
[返回详细的技术说明和代码示例]

示例 3：实时新闻查询

对话
用户: 最近有什么重要的科技新闻？
OpenClaw: [调用 Tavily Search，search_depth: advanced]
以下是最近的重要科技新闻：
1. [新闻标题] - [来源] - [摘要]
2. [新闻标题] - [来源] - [摘要]
...

常见问题

问题 1: API Key 无效或过期

症状: 调用技能时返回 401 或 403 错误。

解决方案:

  1. 检查 .env 文件中的 TAVILY_API_KEY 是否正确
  2. 登录 Tavily 控制台确认 API Key 是否有效
  3. 检查 API Key 是否有足够的配额
  4. 重启 OpenClaw 使新配置生效

问题 2: 搜索结果不准确

症状: 返回的搜索结果与查询不相关。

解决方案:

  1. 尝试使用 search_depth: "advanced" 获取更深入的结果
  2. 增加 max_results 数量以获取更多选项
  3. 使用 include_domains 限定可信来源
  4. 优化查询关键词，使用更具体的描述

问题 3: 超出 API 配额限制

症状: 返回 429 错误（Too Many Requests）。

解决方案:

  1. 登录 Tavily 控制台查看当前配额使用情况
  2. 考虑升级到付费计划以获取更多配额
  3. 在配置中减少 max_results 以节省配额
  4. 实现缓存机制，避免重复搜索相同内容

问题 4: 搜索速度慢

症状: 搜索响应时间过长。

解决方案:

  1. 使用 search_depth: "basic" 而不是 "advanced"
  2. 减少 max_results 数量
  3. 设置 include_raw_content: false 减少数据传输
  4. 检查网络连接是否稳定

💡 更多帮助: 如有其他问题，欢迎通过邮箱 xiaohaha@111.com 联系我们。

相关技能推荐

浏览更多技能 查看实战案例