tavily-search

TotalClaw 作者 totalclaw

通过 Tavily API（Brave 的替代方案）进行网络搜索。当用户要求搜索网络/查找源/查找链接并且 Brave web_search 不可用或不需要时使用。返回一小组相关结果（标题、网址、片段），并且可以选择包含简短的答案摘要。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~openclaw-tavily-search

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~openclaw-tavily-search/file -o openclaw-tavily-search.md

## 概述（中文）

通过 Tavily API（Brave 的替代方案）进行网络搜索。当用户要求搜索网络/查找源/查找链接并且 Brave web_search 不可用或不需要时使用。返回一小组相关结果（标题、网址、片段），并且可以选择包含简短的答案摘要。

## 原文

# 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:

```bash
# 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.