技能库智客分类：其他 tavily-search OpenClaw

Tavily Search

使用Tavily的LLM-优化API进行网络搜索. 以内容片段、分数和元数据返回相关结果.

官方网址：作者主页

技能介绍

先看中文介绍；官方 description 原文单独保留，不改写 SKILL.md。

做什么

使用Tavily的LLM-优化API进行网络搜索. 以内容片段、分数和元数据返回相关结果.

何时用

官方 description 未单独写出 Use when。按规范，代理会在用户任务与这段 description 的关键词匹配时激活本技能。

代理如何加载

按 Agent Skills 渐进披露：启动时只加载 name 与 description（约 100 token）；任务匹配后才读入整份 SKILL.md 正文；scripts/、references/、assets/ 仅在需要时再读。本文件正文结构：Tavily Search、Authentication、Quick Start、Using the Script、Examples、Basic search。其中含规范建议的小节：输入输出示例。

文件分析

文件分析：除 SKILL.md 外，正文引用了 scripts/search.mjs，属于带资源的技能包，这些文件按需再读。

官方 description（原文）

Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata.

Tavily SearchAuthenticationQuick StartUsing the ScriptExamplesBasic searchWith more resultsAdvanced searchNews searchDomain-filtered searchOptionsSearch Depth

来源分类：ClawHub Web Search

来源与网址

市场来源：ClawHub

开源榜 Skill 分类

SKILL.md 与 Agent 调用

官方规范 ↗

name: tavily-search
description: Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata.

发现技能客户端向 Agent 提供名称与描述目录。
匹配与调用用户指定或任务匹配后，载入 SKILL.md 指令。
按需加载按步骤读取参考文档、使用脚本与素材。

指令中引用的文件 · 1

scripts/search.mjs

以下路径提取自原文；文件是否齐全请以来源仓库中的完整目录为准。

具体调用语法与可用工具以目标 Agent 客户端为准。查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围，保留技能包的附属文件，安装后检查客户端能否发现该技能。

该技能引用了附属文件，请从来源获取完整目录；仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理，确认其中的目标目录与客户端匹配。

把 Agent Skill「tavily-search」安装到我的项目：SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-60f79b083b38958d-Tavily-Search.html
请存为 .cursor/skills/tavily-search/SKILL.md 或 .claude/skills/tavily-search/SKILL.md，frontmatter 的 name 与 description 保持原样，不要改写。
该技能还带 scripts/、references/、assets/ 等文件，请从 https://clawhub.ai/skills/liang-tavily-search 取完整目录，不要只建一个 SKILL.md。

当前没有明确的 GitHub 技能包地址，请按来源页面的安装器说明操作。

ClawHub ↗

SKILL.md 原文可复制，不会改动源文件

# Tavily Search

Search the web and get relevant results optimized for LLM consumption.

## Authentication

Get your API key at https://tavily.com and add to your OpenClaw config:

```json
{
  "skills": {
    "entries": {
      "tavily-search": {
        "enabled": true,
        "apiKey": "tvly-YOUR_API_KEY_HERE"
      }
    }
  }
}
```

Or set the environment variable:
```bash
export TAVILY_API_KEY="tvly-YOUR_API_KEY_HERE"
```

## Quick Start

### Using the Script

```bash
node {baseDir}/scripts/search.mjs "query"
node {baseDir}/scripts/search.mjs "query" -n 10
node {baseDir}/scripts/search.mjs "query" --deep
node {baseDir}/scripts/search.mjs "query" --topic news
```

### Examples

```bash
# Basic search
node {baseDir}/scripts/search.mjs "python async patterns"

# With more results
node {baseDir}/scripts/search.mjs "React hooks tutorial" -n 10

# Advanced search
node {baseDir}/scripts/search.mjs "machine learning" --deep

# News search
node {baseDir}/scripts/search.mjs "AI news" --topic news

# Domain-filtered search
node {baseDir}/scripts/search.mjs "Python docs" --include-domains docs.python.org
```

## Options

| Option | Description | Default |
|--------|-------------|---------|
| `-n <count>` | Number of results (1-20) | 10 |
| `--depth <mode>` | Search depth: `ultra-fast`, `fast`, `basic`, `advanced` | `basic` |
| `--topic <topic>` | Topic: `general` or `news` | `general` |
| `--time-range <range>` | Time range: `day`, `week`, `month`, `year` | - |
| `--include-domains <domains>` | Comma-separated domains to include | - |
| `--exclude-domains <domains>` | Comma-separated domains to exclude | - |
| `--raw-content` | Include full page content | false |
| `--json` | Output raw JSON | false |

## Search Depth

| Depth | Latency | Relevance | Use Case |
|-------|---------|-----------|----------|
| `ultra-fast` | Lowest | Lower | Real-time chat, autocomplete |
| `fast` | Low | Good | Need chunks but latency matters |
| `basic` | Medium | High | General-purpose, balanced |
| `advanced` | Higher | Highest | Precision matters, research |

## Tips

- **Keep queries under 400 characters** - Think search query, not prompt
- **Break complex queries into sub-queries** - Better results than one massive query
- **Use `--include-domains`** to focus on trusted sources
- **Use `--time-range`** for recent information
- **Filter by `score`** (0-1) to get highest relevance results

阅读排版

--- name: tavily-search description: Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata. homepage: https://tavily.com metadata: {"openclaw":{"emoji":"🔍","requires":{"bins":["node"],"env":["TAVILY_API_KEY"]},"primaryEnv":"TAVILY_API_KEY"}} --- # Tavily Search Search the web and get relevant results optimized for LLM consumption. ## Authentication Get your API key at https://tavily.com and add to your OpenClaw config: ```json { "skills": { "entries": { "tavily-search": { "enabled": true, "apiKey": "tvly-YOUR_API_KEY_HERE" } } } } ``` Or set the environment variable: ```bash export TAVILY_API_KEY="tvly-YOUR_API_KEY_HERE" ``` ## Quick Start ### Using the Script ```bash node {baseDir}/scripts/search.mjs "query" node {baseDir}/scripts/search.mjs "query" -n 10 node {baseDir}/scripts/search.mjs "query" --deep node {baseDir}/scripts/search.mjs "query" --topic news ``` ### Examples ```bash # Basic search node {baseDir}/scripts/search.mjs "python async patterns" # With more results node {baseDir}/scripts/search.mjs "React hooks tutorial" -n 10 # Advanced search node {baseDir}/scripts/search.mjs "machine learning" --deep # News search node {baseDir}/scripts/search.mjs "AI news" --topic news # Domain-filtered search node {baseDir}/scripts/search.mjs "Python docs" --include-domains docs.python.org ``` ## Options | Option | Description | Default | |--------|-------------|---------| | `-n ` | Number of results (1-20) | 10 | | `--depth ` | Search depth: `ultra-fast`, `fast`, `basic`, `advanced` | `basic` | | `--topic ` | Topic: `general` or `news` | `general` | | `--time-range ` | Time range: `day`, `week`, `month`, `year` | - | | `--include-domains ` | Comma-separated domains to include | - | | `--exclude-domains ` | Comma-separated domains to exclude | - | | `--raw-content` | Include full page content | false | | `--json` | Output raw JSON | false | ## Search Depth | Depth | Latency | Relevance | Use Case | |-------|---------|-----------|----------| | `ultra-fast` | Lowest | Lower | Real-time chat, autocomplete | | `fast` | Low | Good | Need chunks but latency matters | | `basic` | Medium | High | General-purpose, balanced | | `advanced` | Higher | Highest | Precision matters, research | ## Tips - **Keep queries under 400 characters** - Think search query, not prompt - **Break complex queries into sub-queries** - Better results than one massive query - **Use `--include-domains`** to focus on trusted sources - **Use `--time-range`** for recent information - **Filter by `score`** (0-1) to get highest relevance results

Tavily Search

技能介绍

做什么

何时用

代理如何加载

文件分析

SKILL.md 与 Agent 调用

安装这个技能

相关技能

Self Improving Agent

Self Improving + Proactive Agent

Proactive Agent

Multi Search Engine