Tavily 网页搜索
使用内置脚本通过 Tavily 进行网页搜索。
前置要求
- 通过以下任一方式提供 API 密钥:
- 环境变量:
TAVILY_API_KEY - 在
~/.openclaw/.env文件中添加一行:TAVILY_API_KEY=...
- 环境变量:
获取 Tavily API 密钥
- 访问 Tavily 官网 注册账号
- 在控制台获取 API 密钥(免费套餐无需信用卡)
使用命令
从 OpenClaw 工作目录运行:
# 原始 JSON 格式(默认)
python3 ~/.openclaw/skills/tavily-search-zh/scripts/tavily_search.py --query "..." --max-results 5
# 包含简短回答摘要(如有)
python3 ~/.openclaw/skills/tavily-search-zh/scripts/tavily_search.py --query "..." --max-results 5 --include-answer
# 稳定结构(接近 web_search 格式):{query, results:[{title,url,snippet}], answer?}
python3 ~/.openclaw/skills/tavily-search-zh/scripts/tavily_search.py --query "..." --max-results 5 --format brave
# 人类可读的 Markdown 列表
python3 ~/.openclaw/skills/tavily-search-zh/scripts/tavily_search.py --query "..." --max-results 5 --format md
输出格式
raw(默认)
- JSON:
query、可选answer、results: [{title,url,content}]
brave
- JSON:
query、可选answer、results: [{title,url,snippet}]
md
- 紧凑的 Markdown 列表,包含标题/链接/摘要。
使用说明
- 默认将
max-results保持较小值(3–5),以减少 token 消耗和阅读负担。 - 优先返回链接和摘要;仅在需要时再抓取完整页面。
- 支持
--search-depth basic(默认)和--search-depth advanced两种搜索深度。
为什么选择 Tavily?
OpenClaw 内置的 web_search 工具依赖 Brave Search API,申请需要信用卡。Tavily 提供免费套餐,注册即可使用,无需信用卡。
手动测试
python3 ~/.openclaw/skills/tavily-search-zh/scripts/tavily_search.py --query "今天的科技新闻" --max-results 3 --format md