什么是 Tavily 搜索？

Tavily Search 是一款专为自主智能体和大型语言模型（LLM）设计的专业搜索引擎集成。与传统搜索引擎不同，它专注于提供经过优化的内容片段和结构化数据，便于 AI 模型轻松理解和推理。通过将此功能纳入您的 Openclaw Skills 库，您可以让智能体克服知识截止日期的限制，并以精准的速度在实时网络上进行深度研究。

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

安装与下载

1. ClawHub CLI

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

2. 手动安装

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

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

3. 提示词安装

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

Tavily 搜索 应用场景

• 研究超出 LLM 训练截止日期的时事或新闻。
• 利用实时数据进行竞争分析和市场研究。
• 跨多个高权威来源进行信息事实核查。
• 获取开发任务所需的文档和技术资源。
• 使用 Openclaw Skills 内置的图像搜索功能收集视觉资产。

1. 用户或智能体使用提供的 Python 执行脚本触发搜索查询。
2. 该技能通过文件或环境变量进行安全 API 密钥管理，连接到 Tavily API。
3. 使用可自定义的参数（如深度：基础或高级，以及结果数量）执行搜索。
4. Tavily 引擎处理网页并返回结构化结果，包括 URL 和相关性评分。
5. 该技能将输出格式化为易于阅读的文本或程序化的 JSON，供智能体立即使用。

Tavily 搜索 配置指南

要在您的 Openclaw Skills 环境中开始使用此技能，请按照以下步骤操作：

1. 从官方平台获取 Tavily API 密钥。
2. 将您的 API 密钥保存在指定的 secrets 目录中：

mkdir -p workspace/secrets
echo "YOUR_TAVILY_API_KEY" > workspace/secrets/tavily_api_key

3. 运行测试搜索以验证安装：

python3 scripts/search.py "latest trends in Openclaw Skills" --answer

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

该技能返回为 AI 使用而优化的结构化数据。逻辑组织包括：

name: tavily-search
description: Real-time web search using Tavily API optimized for AI agents. Use when you need current information, recent news, factual research, competitive analysis, or any data not in your training cutoff. Searches return structured results with URLs, content snippets, relevance scores, and optional AI-generated answers.

Tavily Search

Web search powered by Tavily API, optimized for AI agent consumption with structured, relevant results.

When to Use

• User asks for current/recent information beyond training cutoff
• Research tasks requiring multiple sources
• Fact-checking or verification
• Competitor analysis, market research
• News and updates on specific topics
• Finding documentation or resources

Quick Start

Basic search (5 results):

python3 scripts/search.py "your query here"

With options:

# Fewer results
python3 scripts/search.py "AI agents" --max-results 3

# AI-generated answer
python3 scripts/search.py "what is OpenClaw" --answer

# Advanced search (deeper crawling)
python3 scripts/search.py "casino bonuses" --depth advanced

# Include images
python3 scripts/search.py "WordPress themes" --images

# Raw JSON output
python3 scripts/search.py "n8n automation" --json

Parameters

• query (required): Search query string
• --max-results N: Number of results (1-10, default 5)
• --depth: Search depth
  • basic (default): Fast, good for most queries
  • advanced: Deeper crawling, more comprehensive
• --answer: Include AI-generated answer summary
• --images: Include relevant image URLs
• --json: Output raw JSON instead of formatted text

Output Structure

Formatted output includes:

• Query and response time
• AI-generated answer (if requested)
• Search results with:
  • Title and URL
  • Relevance score (0-1)
  • Content snippet (truncated to 300 chars)
• Images (if requested)

JSON output provides full Tavily API response for programmatic use.

API Key Setup

The script looks for the Tavily API key in:

1. workspace/secrets/tavily_api_key (OpenClaw workspace)
2. secrets/tavily_api_key (relative to current directory)
3. TAVILY_API_KEY environment variable

Current key is stored at: workspace/secrets/tavily_api_key

Examples

Research task:

python3 scripts/search.py "WordPress plugin security best practices 2026" --max-results 5 --answer

Quick fact check:

python3 scripts/search.py "OpenClaw GitHub repository" --max-results 3

Competitive analysis:

python3 scripts/search.py "top casino affiliate sites" --depth advanced --max-results 10

News monitoring:

python3 scripts/search.py "AI agent frameworks January 2026" --answer

Tips

• Use specific queries for better results
• --answer is useful for summarization tasks
• --depth advanced for comprehensive research (uses more API credits)
• Relevance scores help identify best sources
• --json output is useful for parsing and processing results programmatically