Tavily 搜索：为 AI 代理优化的网络调研 - Openclaw Skills

下载入口:https://github.com/openclaw/skills/tree/main/skills/jacky1n7/openclaw-tavily-search

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install openclaw-tavily-search

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 openclaw-tavily-search。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

什么是 Tavily 搜索？

Tavily Search 是一款专业工具，旨在为 AI 代理提供标准网络搜索引擎之外的强大替代方案。通过利用 Tavily API，此技能允许代理进行深度网络研究、检索结构化片段，并在其工作流程中直接访问简洁的 AI 生成答案。它是 Openclaw Skills 生态系统的核心部分，为互联网连接任务提供可靠的后备或主要来源。

当技术查询需要高相关性结果或代理处理需要特定数据格式时，此技能特别有用。它通过提供各种格式（包括 JSON 和 Markdown）的标题、URL 和片段数据，确保您的代理拥有最新信息。

Tavily 搜索 应用场景

• 在编码或研究会话期间进行事实检查和验证实时信息。
• 检索库和框架的最新文档或 API 参考。
• 使用 Tavily 的 AI 驱动答案引擎生成用户查询的简短摘要回答。
• 在 Openclaw Skills 框架内提供稳健的网络搜索后备方案。

Tavily 搜索 工作原理

1. 用户或代理使用特定的搜索查询和可选参数触发脚本。
2. 脚本使用预配置的 API 密钥通过 Tavily API 进行身份验证。
3. 处理最大结果数和输出格式等参数以精细化搜索请求。
4. Tavily 检索相关网页并提取片段，或根据查询生成直接答案。
5. 结果被解析并以请求的格式（JSON、Brave 兼容或 Markdown）返回，供代理使用。

Tavily 搜索 配置指南

要使用此技能，请确保您拥有有效的 Tavily API 密钥。您可以通过环境变量或配置文件提供密钥。

# 将 API 密钥添加到您的配置中
echo "TAVILY_API_KEY=your_api_key_here" >> ~/.openclaw/.env

直接从您的工作区运行搜索命令：

# 基本搜索
python3 scripts/tavily_search.py --query "Openclaw Skills documentation" --max-results 3

# 包含 AI 生成答案的搜索
python3 scripts/tavily_search.py --query "what is tavily" --include-answer

Tavily 搜索 数据架构与分类体系

该技能提供三种主要格式的结构化搜索数据。以下是 Openclaw Skills 中使用的默认 JSON 结构：

字段	类型	描述
query	string	已处理的原始搜索查询。
answer	string (可选)	如果使用了 --include-answer 标志，则为摘要回答。
results	array	包含标题、url 和片段/内容的搜索结果对象列表。

可用的格式标志包括：用于完整元数据的 raw，用于与标准网络搜索工具模式兼容的 brave，以及用于简洁、易于阅读的 Markdown 列表的 md。

name: tavily-search
description: "Web search via Tavily API (alternative to Brave). Use when the user asks to search the web / look up sources / find links and Brave web_search is unavailable or undesired. Returns a small set of relevant results (title, url, snippet) and can optionally include short answer summaries."

Tavily Search

Use the bundled script to search the web with Tavily.

Requirements

• Provide API key via either:
  • environment variable: TAVILY_API_KEY, or
  • ~/.openclaw/.env line: TAVILY_API_KEY=...

Commands

Run from the OpenClaw workspace:

# raw JSON (default)
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5

# include short answer (if available)
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5 --include-answer

# stable schema (closer to web_search): {query, results:[{title,url,snippet}], answer?}
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5 --format brave

# human-readable Markdown list
python3 {baseDir}/scripts/tavily_search.py --query "..." --max-results 5 --format md

Output

raw (default)

• JSON: query, optional answer, results: [{title,url,content}]

brave

• JSON: query, optional answer, results: [{title,url,snippet}]

md

• A compact Markdown list with title/url/snippet.

Notes

• Keep max-results small by default (3–5) to reduce token/reading load.
• Prefer returning URLs + snippets; fetch full pages only when needed.