Web Search Pro 2.1 核心配置文件

此 ClawHub 包发布了web-search-pro的核心检索配置文件。 它是一个由代码支持的 Node 运行时包，而非仅包含指令的捆绑包。

适用场景

• 调用者需要实时网络搜索或新闻搜索时
• 调用者需要文档查找或代码查找时
• 调用者可能从搜索转向提取、抓取、映射或研究时
• 代理需要可解释的路由和可见的联邦搜索增益时
• 首次运行需要一个真正的无密钥基线时

快速开始

最短的成功路径是：

• 选项 A：无密钥基线
• 选项 B：添加一个高级提供商
• 然后尝试文档、新闻和研究功能

选项 A：无密钥基线

首次成功运行无需 API 密钥。

node {baseDir}/scripts/doctor.mjs --json
node {baseDir}/scripts/bootstrap.mjs --json
node {baseDir}/scripts/search.mjs "OpenAI Responses API docs" --json

选项 B：添加一个高级提供商

如果只添加一个高级提供商，建议从TAVILY_API_KEY.

export TAVILY_API_KEY=tvly-xxxxx
node {baseDir}/scripts/doctor.mjs --json
node {baseDir}/scripts/search.mjs "latest OpenAI news" --type news --json

首次成功搜索

node {baseDir}/scripts/search.mjs "OpenClaw web search" --json
node {baseDir}/scripts/search.mjs "OpenAI Responses API docs" --preset docs --plan --json
node {baseDir}/scripts/extract.mjs "https://platform.openai.com/docs" --json

然后尝试文档、新闻和研究

node {baseDir}/scripts/search.mjs "OpenAI Responses API docs" --preset docs --json
node {baseDir}/scripts/search.mjs "latest OpenAI news" --type news --json
node {baseDir}/scripts/research.mjs "OpenClaw search skill landscape" --plan --json

安装模型

ClawHub 将此套件直接安装为代码支持的 Node 技能包。

• 硬性运行时要求：node
• 基线路径中没有远程安装程序、curl-to-shell 引导程序或 Python 助手传输
• 可选的运行时配置文件：config.json
• 本地状态目录：.cache/web-search-pro

为什么联合搜索很重要

联合不仅仅是“更多的提供者”。它暴露了紧凑的增益指标：

• federated.value.additionalProvidersUsed
• federated.value.resultsRecoveredByFanout
• federated.value.resultsCorroboratedByFanout
• federated.value.duplicateSavings
• routingSummary.federation.value

运行时契约

• selectedProvider规划器的主要路线。
• routingSummary包含置信度和联盟汇总的简明路线解释。
• routing.diagnostics由--explain-routing或--plan命令暴露的完整路线诊断信息。
• federated.providersUsed当扇出激活时，实际返回结果的提供者。
• federated.value关于新增提供者、恢复结果、佐证以及重复节省的简明联盟增益汇总。
• cached/cache代理的缓存命中及TTL遥测数据。
• topicType,topicSignals,researchAxes面向模型的研究包的结构化规划摘要。

按任务划分的命令

包含的命令：

• search.mjs
• extract.mjs
• crawl.mjs
• map.mjs
• research.mjs
• doctor.mjs
• bootstrap.mjs
• capabilities.mjs
• review.mjs
• cache.mjs
• health.mjs

运行时注意事项：

• Node 是唯一的硬性运行时要求。
• 基线配置无需 API 密钥。
• 可选的提供商凭据或端点可扩展覆盖范围。
• 基线出站请求在可用时使用curl，并回退到内置的fetch。

基线：

• 基线不需要API密钥。
• ddg是无密钥搜索的最佳努力方案。
• fetch是无密钥提取/爬取/映射的备用方案。

可选的提供商凭据或端点可解锁更强的覆盖范围：

TAVILY_API_KEY=tvly-xxxxx
EXA_API_KEY=exa-xxxxx
QUERIT_API_KEY=xxxxx
SERPER_API_KEY=xxxxx
BRAVE_API_KEY=xxxxx
SERPAPI_API_KEY=xxxxx
YOU_API_KEY=xxxxx
SEARXNG_INSTANCE_URL=https://searx.example.com

# Perplexity / Sonar: choose one transport path
PERPLEXITY_API_KEY=xxxxx
OPENROUTER_API_KEY=xxxxx
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1  # optional override
KILOCODE_API_KEY=xxxxx

# Or use a custom OpenAI-compatible gateway
PERPLEXITY_GATEWAY_API_KEY=xxxxx
PERPLEXITY_BASE_URL=https://gateway.example.com/v1
PERPLEXITY_MODEL=perplexity/sonar-pro  # accepts sonar* or perplexity/sonar*

审查与诊断：

node {baseDir}/scripts/capabilities.mjs --json
node {baseDir}/scripts/doctor.mjs --json
node {baseDir}/scripts/bootstrap.mjs --json
node {baseDir}/scripts/review.mjs --json

搜索关键词：

网页搜索、新闻搜索、最新更新、时事动态、文档搜索、API文档、代码搜索、公司调研、竞品分析站点爬取站点地图多语言搜索百度搜索答案优先搜索引用答案可解释路由无密钥基线,answer-first search,cited answers,explainable routing,no-key baseline