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

安装与下载

1. ClawHub CLI

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

2. 手动安装

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

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

3. 提示词安装

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

什么是 Tavily 搜索？

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

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

Tavily 搜索 应用场景

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

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 结构：

可用的格式标志包括：用于完整元数据的 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.