网络搜索增强版

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

本功能连接7个搜索服务商（Serper、Tavily、Querit、Exa、Perplexity、You.com、SearXNG），并自动为每次查询匹配最佳选择。购物咨询？→ 调用谷歌结果。研究课题？→ 启动深度研究引擎。需要直接答案？→ 获取带引用的AI综合答复。注重隐私？→ 提供自托管选项。

✨ 核心优势

• 直接搜索——无需纠结选用哪个服务商
• 智能路由——自动分析查询内容并匹配最优服务商
• 七合一的统一界面——谷歌结果、研究引擎、神经搜索、带引用的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"
export QUERIT_API_KEY="your-key"

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

🎯 何时使用哪个提供商

专业提示：正常搜索即可！自动路由能正确处理大多数查询。需要时使用以下命令覆盖：-p 提供商🧠 自动路由的工作原理

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

"iPhone 16 价格" → Serper (购物关键词) "量子计算如何工作" → Tavily (研究性问题) "德国最新人工智能政策更新" → 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 "德国最新人工智能政策更新" python3 scripts/search.py -q "类似 Figma 的初创公司"

python3 scripts/search.py -q "Tesla Model 3 price"
python3 scripts/search.py -q "explain machine learning"
python3 scripts/search.py -q "latest AI policy updates in Germany"
python3 scripts/search.py -q "startups like Figma"

强制使用特定提供商

python3 scripts/search.py -p serper -q "weather Berlin"
python3 scripts/search.py -p tavily -q "quantum computing" --depth advanced
python3 scripts/search.py -p querit -q "latest AI policy updates in Germany"
python3 scripts/search.py -p exa --similar-url "https://stripe.com" --category company
python3 scripts/search.py -p you -q "breaking tech news" --include-news
python3 scripts/search.py -p searxng -q "linux distros" --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 提供商名称手动指定。

🔄 自动回退机制

若某提供商失效（如触发速率限制、超时或报错），技能将自动尝试下一个提供商。您会看到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对于这些
✅ 使用此技能的脚本 —— API 密钥会自动从.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网关）
• You.com— RAG/实时搜索
• SearXNG— 隐私优先的元搜索