Back to Registry
View Author Profile
Official Verified
Tavily Web Search Full
Skill by brucetangc
skill-install — Terminal
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/brucetangc/tavily-web-search-fullOr
name: tavily-web-search description: Complete Tavily toolkit: Search, Extract, Usage, Crawl, Map, Research. All official APIs with safety controls. homepage: https://tavily.com version: 2.0.3 metadata: { "clawdbot": { "emoji": "🔍", "requires": { "bins": ["python3"], "env": ["TAVILY_API_KEY"] }, "primaryEnv": "TAVILY_API_KEY" } }
Tavily Web Search
完整功能的 Tavily 网络搜索工具，基于官方 API 文档实现。专为 AI Agent 和 RAG 工作流设计。
✨ 功能特性
核心功能
- 🔄 自动重试 - 3 次重试 + 指数退避
- 💾 查询缓存 - 1 小时 TTL，节省 API 额度
- 📝 详细日志 -
~/.openclaw/logs/tavily.log - 🎯 多种输出 - JSON / Brave 兼容 / Markdown
官方 API 完整支持
| 功能 | 参数 | 说明 |
|---|---|---|
| 搜索深度 | --search-depth | basic / advanced / fast / ultra-fast |
| 主题分类 | --topic | general / news / finance |
| 时间过滤 | --time-range | day / week / month / year |
| 日期范围 | --start-date / --end-date | YYYY-MM-DD 格式 |
| 域名过滤 | --include-domains / --exclude-domains | 逗号分隔 |
| 国家定向 | --country | united states / china 等 |
| AI 答案 | --include-answer / --answer-type | basic / advanced |
| 完整内容 | --include-raw-content | markdown / text |
| 图片搜索 | --include-images | 包含图片结果 |
| 自动参数 | --auto-parameters | AI 自动配置 |
| 精确匹配 | --exact-match | 精确短语匹配 |
📦 安装
从 ClawHub 安装（推荐）
clawhub install tavily-web-search-full
本地使用
Skill 已放置在：~/.openclaw/workspace/skills/tavily-web-search/
配置 API Key
# 方法 1: 添加到 ~/.openclaw/.env
echo "TAVILY_API_KEY=tvly-your-key-here" >> ~/.openclaw/.env
# 方法 2: 环境变量
export TAVILY_API_KEY="tvly-your-key-here"
获取 API Key: https://app.tavily.com/home (每月 1000 免费信用)
🚀 使用示例
🔍 Search API（搜索）
# 简单搜索（默认 compact Markdown 输出）
python3 {baseDir}/scripts/search.py --query "Python tutorial"
# 指定结果数量
python3 {baseDir}/scripts/search.py --query "Docker compose" --max-results 10
# 新闻搜索
python3 {baseDir}/scripts/search.py --query "AI breakthrough" --topic news --time-range day
# 深度研究
python3 {baseDir}/scripts/search.py --query "LLM architecture" --search-depth advanced
# 域名过滤
python3 {baseDir}/scripts/search.py --query "React" --include-domains "github.com,dev.to"
📄 Extract API（URL 内容提取）
# 提取单个 URL
python3 {baseDir}/scripts/extract.py --urls "https://example.com/article"
# 提取多个 URL
python3 {baseDir}/scripts/extract.py --urls "https://a.com,https://b.com,https://c.com"
# 带查询提取（按相关性重排内容）
python3 {baseDir}/scripts/extract.py --urls "https://example.com" --query "find pricing information"
# 高级提取（更详细，2 信用/5 URL）
python3 {baseDir}/scripts/extract.py --urls "https://example.com" --extract-depth advanced
# 包含图片
python3 {baseDir}/scripts/extract.py --urls "https://example.com" --include-images
# 输出为纯文本
python3 {baseDir}/scripts/extract.py --urls "https://example.com" --format text
📊 Usage API（使用量查询）
# 查看使用量（简洁模式）
python3 {baseDir}/scripts/usage.py
Metadata
AI Skill Finder
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skill Add to Configuration
Paste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-brucetangc-tavily-web-search-full": {
"enabled": true,
"auto_update": true
}
}
}Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.