Tavily Search 安装部署使用教程

Tavily 是一个专为 LLM 优化的搜索引擎，返回的搜索结果包含内容摘要和相关性评分，可以直接用于 AI 对话。下面介绍如何在 OpenClaw 中安装和配置 Tavily Search。

功能概述

• • LLM 优化：结果包含摘要和相关性评分
• • 多深度搜索：ultra-fast、fast、basic、advanced 四种深度
• • 时间过滤：day、week、month、year
• • 领域过滤：包含或排除特定网站
• • 多主题：general、news、finance
• • 快速响应：basic 深度通常 1 秒内返回

安装 Skill

使用 clawhub：

clawhub install liang-tavily-search

使用 Skills CLI：

npx skills add tavily-ai/skills@tavily-search -g -y

安装后 Skill 会自动 symlink 到 OpenClaw 的 skills 目录。

安装 Tavily CLI

Tavily Search Skill 依赖 Tavily CLI 工具。

检查是否已安装：

tvly --version

如果没有 tvly 命令，执行：

curl -fsSL https://cli.tavily.com/install.sh | bash

安装后自动添加到 PATH。

配置 API Key

获取 API Key

1. 1. 访问 tavily.com
2. 2. 注册或登录账号
3. 3. 在个人设置或 API 页面获取 Key

配置方式

环境变量（推荐）

在 ~/.zshrc 或 ~/.bashrc 中添加：

export TAVILY_API_KEY="tvly-your-api-key-here"

执行 source ~/.zshrc 生效。

命令行登录

tvly login

按提示输入 API Key。

基础使用

基本搜索

tvly search "你的搜索关键词" --json

指定结果数量

tvly search "Python 教程" --max-results 10 --json

按时间过滤

tvly search "AI 新闻" --time-range week --json

可选值：day、week、month、year

在 OpenClaw 中使用

直接对话即可：

帮我搜一下微信接入 OpenClaw 的最新消息

OpenClaw 会自动调用：

tvly search "微信接入 OpenClaw 最新消息" --time-range month --max-results 10 --json

高级功能

新闻搜索

tvly search "科技新闻" --topic news --time-range day --json

只搜索特定网站

tvly search "机器学习" --include-domains arxiv.org,github.com --json

排除某些网站

tvly search "Python" --exclude-domains spammy-site.com --json

保存结果到文件

tvly search "AI 发展" --json -o results.json