Web Search Pro 2.1 核心配置文件

该 ClawHub 包发布 web-search-pro 的核心检索配置。

这是一个以代码为支撑的 Node 运行时包，而非仅含指令的捆绑包。

适用此技能的场景

• 调用方需要实时网页搜索或新闻搜索
• 调用方需要文档查找或代码查找
• 调用方可从搜索继续执行提取（extract）、爬取（crawl）、映射（map）或研究（research）等操作
• 智能体需要可解释的路由决策，并能显式观测联邦搜索（federated-search）带来的增益
• 首次运行需基于真实“免密钥”（no-key）基线

快速入门

最短的成功路径如下：

• 选项 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

为何联邦搜索至关重要

联邦化（Federation）远不止“接入更多服务商”。它可暴露紧凑、可量化的增益指标：

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

运行时契约（Runtime Contract）

• selectedProvider 规划器（planner）选定的主要路由服务商。
• routingSummary 包含置信度与联邦摘要的精简版路由说明。
• routing.diagnostics 由 --explain-routing 或 --plan 暴露的完整路由诊断信息。
• federated.providersUsed 在启用 fanout 机制时，实际返回结果的服务提供商列表。
• federated.value 针对新增服务商、恢复结果数、交叉验证结果数及去重节省量等维度的紧凑型联邦增益汇总。
• cached / cache 缓存命中状态及 TTL 遥测数据，供智能体使用。
• topicType、topicSignals、researchAxes 面向模型的「研究包」（research pack）所生成的结构化规划摘要。

按任务划分的命令

本包包含以下命令：

• 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 提供尽力而为（best-effort）的免密钥搜索。
• fetch 作为免密钥模式下的提取（extract）、爬取（crawl）与映射（map）回退方案。

可选服务商凭据或端点可解锁更强覆盖能力：

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：任选一种传输路径
PERPLEXITY_API_KEY=xxxxx
OPENROUTER_API_KEY=xxxxx
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1  # 可选覆写
KILOCODE_API_KEY=xxxxx

# 或使用自定义 OpenAI 兼容网关
PERPLEXITY_GATEWAY_API_KEY=xxxxx
PERPLEXITY_BASE_URL=https://gateway.example.com/v1
PERPLEXITY_MODEL=perplexity/sonar-pro  # 支持 sonar* 或 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

搜索关键词参考：

web search、news search、latest updates、current events、docs search、API docs、code search、company research、competitor analysis、site crawl、site map、multilingual search、Baidu search、answer-first search、cited answers、explainable routing、no-key baseline