名称： web-search-plus
版本： 2.8.1
描述： 具备智能自动路由的统一搜索技能。通过多信号分析，自动在 Serper (谷歌)、Tavily (研究)、Exa (神经搜索)、Perplexity (AI 答案)、You.com (RAG/实时) 和 SearXNG (隐私/自托管) 之间进行选择，并提供置信度评分。
标签： [search, web-search, serper, tavily, exa, perplexity, you, searxng, google, research, semantic-search, auto-routing, multi-provider, shopping, rag, free-tier, privacy, self-hosted, kilo]
元数据： {"openclaw":{"requires":{"bins":["python3","bash"],"env":{"SERPER_API_KEY":"optional","TAVILY_API_KEY":"optional","EXA_API_KEY":"optional","YOU_API_KEY":"optional","SEARXNG_INSTANCE_URL":"optional","KILOCODE_API_KEY":"optional — required for Perplexity provider (via Kilo Gateway)"},"note":"Only ONE provider key needed. All are optional."}}}

Web Search Plus

无需手动选择搜索引擎，让技能为您代劳。

本技能连接了 6 个搜索提供商（Serper、Tavily、Exa、Perplexity、You.com、SearXNG），并自动为每个查询选择最佳的一个。购物问题？→ 谷歌结果。研究问题？→ 深度研究引擎。需要直接答案？→ AI 综合并附引文。注重隐私？→ 自托管选项。

✨ 与众不同之处

• 只管搜索 — 无需思考该用哪个提供商
• 智能路由 — 分析您的查询并自动选择最佳提供商
• 6 合 1 接口 — 谷歌结果、研究引擎、神经搜索、带引文的 AI 答案、RAG 优化、隐私优先，一应俱全
• 只需一个密钥即可启动 — 从任意一个提供商开始，后续可随时添加
• 提供免费选项 — SearXNG 完全免费（自托管）

🚀 快速开始

# 交互式设置（首次运行推荐）
python3 scripts/setup.py

# 或手动：复制配置文件并添加您的密钥
cp config.example.json config.json

向导会解释每个提供商，收集 API 密钥，并配置默认设置。

🔑 API 密钥

您只需要 一个 密钥即可开始。后续可以添加更多提供商以获得更好的覆盖。

设置密钥：

# 选项 A: .env 文件（推荐）
export SERPER_API_KEY="your-key"
export TAVILY_API_KEY="your-key"

# 选项 B: config.json
{ "serper": { "api_key": "your-key" } }

🎯 何时使用哪个提供商

专业提示： 像平常一样搜索即可！自动路由能正确处理大多数查询。需要时可用 -p provider 覆盖。

🧠 自动路由如何工作

本技能会分析您的查询并选择最佳提供商：

"iPhone 16 价格"              → Serper (购物关键词)
"量子计算如何工作" → Tavily (研究问题)
"类似 stripe.com 的公司"    → Exa (检测到 URL，相似性)
"格拉茨本周末活动"  → Perplexity (本地 + 直接答案)
"AI 最新新闻"            → You.com (实时意图)
"私密搜索"             → SearXNG (隐私关键词)

如果选错了怎么办？ 手动覆盖：python3 scripts/search.py -p tavily -q "您的查询"

调试路由： python3 scripts/search.py --explain-routing -q "您的查询"

📖 使用示例

让自动路由选择（推荐）

python3 scripts/search.py -q "特斯拉 Model 3 价格"
python3 scripts/search.py -q "解释机器学习"
python3 scripts/search.py -q "类似 Figma 的初创公司"

强制使用特定提供商

python3 scripts/search.py -p serper -q "柏林天气"
python3 scripts/search.py -p tavily -q "量子计算" --depth advanced
python3 scripts/search.py -p exa --similar-url "https://stripe.com" --category company
python3 scripts/search.py -p you -q "突发科技新闻" --include-news
python3 scripts/search.py -p searxng -q "Linux 发行版" --engines "google,bing"

⚙ 配置

{
  "auto_routing": {
    "enabled": true,
    "fallback_provider": "serper",
    "confidence_threshold": 0.3,
    "disabled_providers": []
  },
  "serper": {"country": "us", "language": "en"},
  "tavily": {"depth": "advanced"},
  "exa": {"type": "neural"},
  "you": {"country": "US", "include_news": true},
  "searxng": {"instance_url": "https://your-instance.example.com"}
}

📊 提供商对比

❓ 常见问题

我需要所有提供商的 API 密钥吗？

不需要。 您只需要为您想使用的提供商配置密钥。从一个开始（推荐 Serper），后续再添加。

我应该从哪个提供商开始？

Serper — 最快、最便宜、免费额度最大（每月 2,500 次查询），并且能很好地处理大多数查询。

如果免费额度用完了怎么办？

技能会自动回退到您配置的其他提供商。或者切换到 SearXNG（无限，自托管）。

这需要多少费用？

• 免费额度： 2,500 (Serper) + 1,000 (Tavily) + 1,000 (Exa) = 每月 4,500+ 次免费搜索
• SearXNG： 完全免费（如果在 VPS 上自托管，每月约 5 美元）
• 付费计划： 根据提供商不同，每月约 10-50 美元起

SearXNG 真的私密吗？

是的，如果自托管。 您控制服务器，无跟踪，无画像。公共实例取决于运营者的政策。

如何设置 SearXNG？

# Docker (5 分钟)
docker run -d -p 8080:8080 searxng/searxng

然后在 settings.yml 中启用 JSON API。参见 docs.searxng.org。

为什么我的查询被路由到了“错误”的提供商？

有时查询是模糊的。使用 --explain-routing 查看原因，然后如果需要，用 -p provider 覆盖。

🔄 自动回退

如果一个提供商失败（速率限制、超时、错误），技能会自动尝试下一个提供商。当发生这种情况时，您会在响应中看到 routing.fallback_used: true。

📤 输出格式

{
  "provider": "serper",
  "query": "iPhone 16 价格",
  "results": [{"title": "...", "url": "...", "snippet": "...", "score": 0.95}],
  "routing": {
    "auto_routed": true,
    "provider": "serper",
    "confidence": 0.78,
    "confidence_level": "high"
  }
}

⚠ 重要提示

Tavily、Serper 和 Exa 不是 OpenClaw 的核心提供商。

❌ 不要修改 ~/.openclaw/openclaw.json 来配置这些
✅ 使用本技能的脚本 — 密钥会自动从 .env 加载

🔒 安全

SearXNG SSRF 防护： SearXNG 实例 URL 经过深度防御验证：
- 仅允许 http/https 协议
- 阻止云元数据端点 (169.254.169.254, metadata.google.internal)
- 解析主机名并阻止私有/内部 IP（环回、RFC1918、链路本地、保留地址）
- 有意在私有网络自托管的管理员可以设置 SEARXNG_ALLOW_PRIVATE=1

📚 更多文档

• FAQ.md — 更多问题的详细解答
• TROUBLESHOOTING.md — 修复常见错误
• README.md — 完整技术参考

🔗 快速链接

• Serper — 谷歌搜索 API
• Tavily — AI 研究搜索
• Exa — 神经搜索
• Perplexity — AI 综合答案 (通过 Kilo Gateway)
• You.com — RAG/实时搜索
• SearXNG — 隐私优先元搜索