介绍
# Web Search Pro
多引擎精细化网络搜索，为 AI Agent 设计。 作为 OpenClaw 内置 `web_search`（Brave/Perplexity）的精细化补充，提供域名过滤、 深度搜索、新闻模式、日期范围、内容提取等内置搜索不支持的能力。 配置一个或多个 API Key，自动选择最优引擎。
## 引擎
| 引擎 | 优势 | 免费额度 | API Key 环境变量 | |--------|-----------|-----------|-------------| | **Tavily** | AI 优化，最佳答案质量，完整过滤器，提取 | 1000次/月 | `TAVILY_API_KEY` | | **Exa** | 语义/神经搜索，深度研究 | $10 额度 | `EXA_API_KEY` | | **Serper** | 实时 Google SERP，最佳新闻覆盖 | 100次/月 | `SERPER_API_KEY` | | **SerpAPI** | 多引擎 (Google/Bing/Baidu/Yandex/DuckDuckGo) | 250次/月 | `SERPAPI_API_KEY` |
## 自动选择优先级
当未指定 `--engine` 时，该技能会选取最佳可用引擎：
| 查询类型 | 优先级 | 原因 | |------------|----------|--------| | 默认 | Tavily > Exa > Serper > SerpAPI | Tavily 拥有最佳 AI 答案 + 完整过滤器 | | `--deep` | Tavily > Exa | 两者均具有专用深度搜索模式 | | `--news` | Serper > Tavily | Google 新闻覆盖面最广 | | `--include-domains` | Tavily > Exa > Serper > SerpAPI | Tavily/Exa 拥有原生域名过滤器 | | `--search-engine baidu` | SerpAPI | 仅 SerpAPI 支持 Baidu/Yandex | | 中文查询 | SerpAPI (Baidu) > Serper | Baidu 中文结果更佳 |
## 搜索
```bash # Basic search (auto-select engine) node {baseDir}/scripts/search.mjs "query"
# Force specific engine node {baseDir}/scripts/search.mjs "query" --engine tavily
# Domain filtering (only search specific sites) node {baseDir}/scripts/search.mjs "query" --include-domains "github.com,stackoverflow.com"
# Exclude domains node {baseDir}/scripts/search.mjs "query" --exclude-domains "pinterest.com,quora.com"
# Date range (absolute) node {baseDir}/scripts/search.mjs "query" --from 2026-01-01 --to 2026-02-09
# Time range (relative) node {baseDir}/scripts/search.mjs "query" --time-range week
# Deep/advanced search node {baseDir}/scripts/search.mjs "query" --deep
# News search node {baseDir}/scripts/search.mjs "query" --news --days 7
# Multi-engine: Baidu search node {baseDir}/scripts/search.mjs "query" --engine serpapi --search-engine baidu
# More results node {baseDir}/scripts/search.mjs "query" -n 10
# JSON output (for programmatic use) node {baseDir}/scripts/search.mjs "query" --json ```
## 内容提取
从 URL 提取可读内容（Tavily Extract 或 Exa livecrawl）：
```bash node {baseDir}/scripts/extract.mjs "https://example.com/article" node {baseDir}/scripts/extract.mjs "url1" "url2" "url3" node {baseDir}/scripts/extract.mjs "url" --engine exa node {baseDir}/scripts/extract.mjs "url" --json ```
## 全部参数
| 选项 | 描述 | 引擎 | |--------|-------------|---------| | `--engine <name>` | 强制指定引擎：tavily\|exa\|serper\|serpapi | 全部 | | `-n <count>` | 结果数量（默认：5） | 全部 | | `--deep` | 深度/高级搜索模式 | tavily, exa | | `--news` | 新闻搜索模式 | tavily, serper, serpapi | | `--days <n>` | 将新闻限制在过去 N 天内 | tavily | | `--include-domains <d,...>` | 仅搜索这些域名 | 全部（原生支持：tavily, exa） | | `--exclude-domains <d,...>` | 排除这些域名 | 全部（原生支持：tavily, exa） | | `--time-range <range>` | day\|week\|month\|year | 全部 | | `--from <YYYY-MM-DD>` | 此日期之后的结果 | 全部 | | `--to <YYYY-MM-DD>` | 此日期之前的结果 | 全部 | | `--search-engine <name>` | SerpAPI 子引擎：google\|bing\|baidu\|yandex\|duckduckgo | serpapi | | `--country <code>` | 国家代码（us, cn, de...） | serper, serpapi | | `--lang <code>` | 语言代码（en, zh, de...） | serper, serpapi | | `--json` | 原始 JSON 输出 | 全部 |
## 配置
将 API Key 添加到环境变量中（例如 `~/.openclaw/.env`）：
```bash # Configure at least one (recommended: Tavily) TAVILY_API_KEY=tvly-xxxxx # https://tavily.com (1000 free/month) EXA_API_KEY=exa-xxxxx # https://exa.ai ($10 free credit) SERPER_API_KEY=xxxxx # https://serper.dev (100 free/month) SERPAPI_API_KEY=xxxxx # https://serpapi.com (250 free/month) ```
## 说明
- 至少需配置一个 API Key - 域名过滤通过 `--include-domains`/`--exclude-domains` 在 Tavily 和 Exa 上原生支持；在 Serper/SerpAPI 上通过 `site:` 查询运算符实现 - `--deep` 模式消耗更多 API 配额（Tavily：2倍，Exa：不定） - 提取功能仅适用于 Tavily 和 Exa - 所有输出均格式化为 Markdown 以供 AI Agent 使用；如需编程访问请使用 `--json`