web-search-plus-zh

name: web-search-plus-zh version: 2.9.0 description: 智能自动路由的统一搜索技能。通过多信号分析自动选择 Serper（Google）、Tavily（研究）、Querit（多语言 AI 搜索）、Exa（神经网络）、Perplexity（AI 问答）、You.com（RAG/实时）和 SearXNG（隐私/自托管），并附带置信度评分。 tags: [search, web-search, serper, tavily, querit, exa, perplexity, you, searxng, google, multilingual-search, research, semantic-search, auto-routing, multi-provider, shopping, rag, free-tier, privacy, self-hosted, kilo] metadata: {"openclaw":{"requires":{"bins":["python3","bash"],"env":{"SERPER_API_KEY":"optional","TAVILY_API_KEY":"optional","QUERIT_API_KEY":"optional","EXA_API_KEY":"optional","YOU_API_KEY":"optional","SEARXNG_INSTANCE_URL":"optional","KILOCODE_API_KEY":"optional — Perplexity 提供商需要（通过 Kilo Gateway）"},"note":"只需配置一个提供商的密钥即可。所有密钥均为可选。"}}}

Web Search Plus

不用纠结用哪个搜索引擎了，让技能替你选择。

本技能连接 7 个搜索提供商（Serper、Tavily、Querit、Exa、Perplexity、You.com、SearXNG），并为每次查询自动选择最佳引擎。购物问题？→ Google 结果。研究问题？→ 深度研究引擎。需要直接答案？→ AI 合成并附带引用。重视隐私？→ 自托管方案。

✨ 有什么不同？

• 直接搜 — 无需思考该用哪个提供商
• 智能路由 — 分析你的查询并自动选择最佳提供商
• 7 个提供商，1 个接口 — Google 结果、研究引擎、神经搜索、AI 问答带引用、RAG 优化和隐私优先，全部整合
• 只需 1 个密钥 — 从任意一个开始，以后再添加更多
• 免费选项 — SearXNG 完全免费（自托管）

🚀 快速开始

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

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

向导会逐一介绍每个提供商、收集 API 密钥并配置默认设置。

🔑 API 密钥

只需 一个 密钥即可开始使用。以后可以添加更多提供商以获得更全面的覆盖。

设置密钥：

# 方式 A：.env 文件（推荐）
export SERPER_API_KEY="你的密钥"
export TAVILY_API_KEY="你的密钥"
export QUERIT_API_KEY="你的密钥"

# 方式 B：config.json
{ "serper": { "api_key": "你的密钥" } }

🎯 什么时候用哪个提供商

专业提示： 正常搜索就好！自动路由能正确处理大多数查询。需要时用 -p provider 手动覆盖。

🧠 自动路由的工作原理

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

"iPhone 16 价格"              → Serper（购物关键词）
"量子计算是怎么工作的"        → Tavily（研究问题）
"德国最新 AI 政策动态"        → Querit（多语言 + 时效性）
"类似 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 "德国最新 AI 政策动态"
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 querit -q "德国最新 AI 政策动态"
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 — Google 搜索 API
• Tavily — AI 研究搜索
• Exa — 神经网络搜索
• Perplexity — AI 合成回答（通过 Kilo Gateway）
• You.com — RAG/实时搜索
• SearXNG — 隐私优先元搜索