Web search tools. Use when the user requests web search, needs information from the internet, wants to research a topic, or find answers online.
多源网页搜索，支持自动降级。引擎链：SearXNG → Serper → Tavily → Bing → DuckDuckGo → Ollama
Array<{title, url, source, body}>fallback（顺序降级）、random（随机顺序）、aggregate（并行聚合）| 变量 | 说明 | 必须 |
|---|---|---|
SEARXNG_URL | SearXNG 实例地址，如 http://127.0.0.1:8081 | 可选 |
SERPER_API_KEY | Serper.dev API Key | 可选 |
TAVILY_API_KEY | Tavily API Key | 可选 |
BING_API_KEY | Bing Web Search API Key | 可选 |
OLLAMA_API_KEY | Ollama 云端搜索 API Key (ollama.com/settings/keys) | 可选 |
JINA_API_KEY |
Jina Reader API Key，--deep 时抓取完整网页内容（jina.ai/api-access）。不设置时自动降速模式 |
| 可选 |
| 策略 | 说明 | 适合场景 |
|---|---|---|
fallback（默认） | 按优先级顺序尝试，第一个成功即返回 | 速度优先，节省 API 配额 |
random | 随机化引擎顺序后依次降级 | 负载均衡，避免单一引擎压力 |
aggregate | 所有引擎并行搜索，结果去重合并 | 覆盖率优先，需要多视角结果 |
| 场景 | 推荐引擎 | 说明 |
|---|---|---|
| 中文内容搜索 | SearXNG (cn-zh) / Bing | 国内源，中文结果质量高 |
| 全球英文搜索 | Serper / Tavily | Google 质量，国际覆盖好 |
| 新闻资讯 | Serper (topic=news) / Bing | 实时性好 |
| AI/技术文档 | Tavily | AI 优化，代码/文档友好 |
| 无 API 场景 | DuckDuckGo | 无需配置，始终可用 |
| 多结果覆盖 | aggregate 策略 | 多引擎并行，去重后合并 |
SKILL_DIR=~/.openclaw/skills/aggregated-search
# 基础搜索（自动降级）
node $SKILL_DIR/scripts/search.mjs "搜索词"
# 指定返回数量
node $SKILL_DIR/scripts/search.mjs "搜索词" -n 10
# 列出所有可用引擎
node $SKILL_DIR/scripts/search.mjs --list
# 指定引擎（跳过降级）
node $SKILL_DIR/scripts/search.mjs "搜索词" --source searxng
node $SKILL_DIR/scripts/search.mjs "搜索词" --source serper
node $SKILL_DIR/scripts/search.mjs "搜索词" --source tavily
node $SKILL_DIR/scripts/search.mjs "搜索词" --source bing
node $SKILL_DIR/scripts/search.mjs "搜索词" --source duckduckgo
node $SKILL_DIR/scripts/search.mjs "搜索词" --source ollama
# 搜索策略
node $SKILL_DIR/scripts/search.mjs "搜索词" --strategy fallback # 顺序降级（默认）
node $SKILL_DIR/scripts/search.mjs "搜索词" --strategy random # 随机顺序降级
node $SKILL_DIR/scripts/search.mjs "搜索词" --strategy aggregate # 并行聚合所有引擎
# 地区与语言
node $SKILL_DIR/scripts/search.mjs "搜索词" --region zh-CN
node $SKILL_DIR/scripts/search.mjs "搜索词" --region en-US
# 时间范围
node $SKILL_DIR/scripts/search.mjs "搜索词" --time day
node $SKILL_DIR/scripts/search.mjs "搜索词" --time week
node $SKILL_DIR/scripts/search.mjs "搜索词" --time month
node $SKILL_DIR/scripts/search.mjs "搜索词" --time year
# 搜索主题
node $SKILL_DIR/scripts/search.mjs "搜索词" --topic news
node $SKILL_DIR/scripts/search.mjs "搜索词" --topic images
node $SKILL_DIR/scripts/search.mjs "搜索词" --topic videos
# 深度搜索（Tavily advanced 模式）
node $SKILL_DIR/scripts/search.mjs "搜索词" --deep
# 详细模式（显示使用了哪个引擎）
node $SKILL_DIR/scripts/search.mjs "搜索词" --verbose
# 超时控制
node $SKILL_DIR/scripts/search.mjs "搜索词" --timeout 15
| 选项 | 说明 | 默认值 |
|---|---|---|
-n <count> | 结果数量 | 5 |
--source <name> | 指定引擎 | 自动降级 |
--strategy <mode> | 搜索策略：fallback/random/aggregate | fallback |
--region <code> | 地区代码 | zh-CN |
--time <range> | 时间范围：day/week/month/year | 无限制 |
--topic <type> | 主题：general/news/images/videos | general |
--deep | 深度搜索：Tavily 用 advanced 模式；其余引擎通过 Jina Reader 抓取 Markdown（跳过5行元数据，最多30行/1000字）；Ollama 不支持 | false |
--verbose | 显示引擎来源信息 | false |
--timeout <sec> | 超时秒数 | 30 |
--list | 列出可用引擎及状态 | — |
结果以 JSON 数组形式输出到 stdout，日志输出到 stderr：
[
{
"title": "页面标题",
"url": "https://example.com/page",
"source": "duckduckgo",
"body": "页面摘要或内容片段..."
}
]
| 引擎 | 时间范围支持 | 备注 |
|---|---|---|
| SearXNG | day/month/year（无 week） | 聚合多个搜索引擎，支持 pageno/safesearch/engines 参数 |
| Serper | hour/day/week/month/year | Google 搜索结果，支持翻页 |
| Tavily | day/week/month/year（仅 news） | AI 优化结果，支持 deep 模式 |
| Bing | day/week/month（无 year） | Microsoft Bing 官方 API |
| DuckDuckGo | day/week/month/year | 无需 API Key，始终可用 |
| Ollama | 无 | Ollama 云端 REST API，非本地推理 |
无结果时：
-n 10--deep 深度搜索--source 单独测试某个引擎--strategy aggregate 多引擎并行搜索--list 检查哪些引擎已配置通过 Jina Reader 抓取任意网页内容，返回 Markdown 格式。
无 JINA_API_KEY 时自动降速模式板运行，配置后无速率限制。
SKILL_DIR=~/.openclaw/skills/aggregated-search
# 抓取完整 Markdown
node $SKILL_DIR/scripts/web_fetch.mjs "https://example.com/article"
# 截取模式：跳过前5行元数据，最多 30 行 / 1000 字
node $SKILL_DIR/scripts/web_fetch.mjs "https://example.com/article" --trim
# 自定义行数和字数限制
node $SKILL_DIR/scripts/web_fetch.mjs "https://example.com/article" --trim --max-lines 50 --max-chars 2000
| 选项 | 说明 | 默认値 |
|---|---|---|
--trim | 截取模式：跳过前 5 行元数据，按行数/字符限制 | false |
--max-lines <n> | 最多返回行数 (需配合 --trim) | 30 |
--max-chars <n> | 最多返回字符数 (需配合 --trim) | 1000 |
--timeout <ms> | 超时毫秒数 | 20000 |
| 变量 | 说明 |
|---|---|
JINA_API_KEY | 可选。不设置时自动降速运行 |
{ "url": "https://example.com/article", "content": "# 标题\n\n...Markdown 内容..." }
失败时：
{ "url": "https://example.com/article", "error": "错误信息" }