online-search

name	online-search
description	元宝搜索标准版工具。是腾讯元宝的联网搜索服务，提供实时、精准的互联网内容检索能力。 核心特性：覆盖大量中文网站，包括官方媒体、政府网站等高权威性来源，以及腾讯系核心内容资源。多层精调排序策略，提供准确的内容匹配和排序。
metadata	{"openclaw":{"emoji":"🔍"}}

联网搜索工具 (ProSearch)

通过天集 ProSearch 搜索引擎查询实时互联网信息，返回网页搜索结果（标题、摘要、链接、来源）。

Setup

无需额外安装依赖。搜索通过 Node.js 脚本 <SCRIPT_PATH>/scripts/prosearch.cjs 调用本地 HTTP 接口 /proxy/prosearch 完成，鉴权由后台网关自动处理（基于用户登录态），无需手动配置凭证。

---

Workflow

QClaw uses this skill whenever the user needs real-time information from the internet.

Complete flow

User asks a question requiring real-time information
  → Step 1: Determine search keyword (concise, specific)
  → Step 1.5: Determine time freshness — add from_time/to_time if recency matters
  → Step 2: Call search API via node script
  → Step 3: Output the `message` field from JSON response VERBATIM (search result items with clickable links) — NEVER skip this
  → Step 4: Add analysis/summary after the result items (optional)

CRITICAL — Anti-hallucination design: The search API returns a pre-rendered message field containing the complete formatted search results (titles as clickable hyperlinks, snippets, URLs, sources). QClaw MUST output message verbatim as the primary search results — NEVER skip the result items. QClaw may then add analysis or summary AFTER the verbatim results, but must NOT fabricate or modify any URLs or source information.

Step 1: Determine search keyword

Convert the user's question into an effective search keyword:

User says	Search keyword
"最近的 AI 新闻"	最近AI新闻
"现在黄金价格多少"	今日黄金价格
"React 19 有什么新特性"	React 19 新特性
"深圳今天天气怎么样"	深圳今天天气

Tips for good keywords:

• Keep it concise (2-6 words)
• Remove filler words ("帮我"、"请问"、"一下")
• Add time context if relevant ("今日"、"2026"、"最新")
• Use the user's language (Chinese query for Chinese user, English query for English user)
• Preserve the keyword's original language — do NOT translate keywords. If the user provides an English keyword (e.g. "search for React Server Components"), keep it in English. If the user provides a Chinese keyword, keep it in Chinese.

Step 1.5: Determine time freshness (IMPORTANT for recency)

When the user's question implies recency, QClaw MUST add --freshness 参数 to the search request to filter out stale results. This is critical for improving search result freshness.

Time freshness decision table:

User intent signal	--freshness value	Example
"今天"、"today"、"刚刚"	--freshness=24h	Stock price today
"最近"、"最新"、"recently"、"latest"	--freshness=7d	Latest AI news
"这周"、"this week"	--freshness=7d	This week's events
"这个月"、"this month"	--freshness=30d	This month's policy
"今年"、"2026年"	--freshness=1y	2026 events
No time signal (general facts)	不加 --freshness	"What is React?"

--freshness 快捷参数：脚本内部自动计算 from_time/to_time 时间戳，无需手动计算。

支持的值：

• --freshness=24h 或 --freshness=1d → 最近 24 小时
• --freshness=7d → 最近 7 天
• --freshness=30d → 最近 30 天
• --freshness=1y → 最近 1 年

⚠️ 互斥规则: --freshness（或 --from_time/--to_time）与 --cnt 互斥，不能同时使用。

Step 2: Search

所有平台统一使用 --key=value 参数模式，macOS / Linux / Windows 命令完全一致，无需区分操作系统。

# 基础搜索
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=搜索关键词

⏰ Freshness search — 使用 --freshness 快捷参数（脚本自动计算时间戳）:

# 搜索最近 24 小时的结果（适用于"今天"、"刚刚"类查询）
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=搜索关键词 --freshness=24h

# 搜索最近 7 天的结果（适用于"最新"、"最近"类查询）
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=搜索关键词 --freshness=7d

# 搜索最近 30 天的结果（适用于"这个月"类查询）
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=搜索关键词 --freshness=30d

With optional parameters:

# 指定返回数量 (10/20/30/40/50) — ⚠️ 不能与 --freshness/--site 同时使用
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=搜索关键词 --cnt=20

# 站内搜索（⚠️ 不要同时传 --cnt）
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=搜索关键词 --site=github.com

# 垂类搜索 (gov/news/acad)
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=搜索关键词 --industry=news

# 获取 VR 卡数据（天气、金价等）
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=今日黄金价格 --mode=2

# 组合：新闻类 + 最近 24 小时
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=国内最新新闻 --freshness=24h --industry=news

关键词含空格时：用双引号包裹值部分，如 --keyword="React 19 features"

--freshness 和 --cnt 互斥，不能同时使用。也可用 --from_time=秒级时间戳 --to_time=秒级时间戳 精确指定时间范围。

Step 3: Output search results — ALWAYS show result items with clickable links, then add analysis

搜索接口返回 JSON 后，QClaw 必须 按以下固定格式输出，不可省略任何部分：

Part A: 搜索结果条目展示 [MANDATORY — 不可跳过]

必须先原样输出 message 字段。message 中包含 前 5 条 最相关的搜索结果（即使 API 返回了更多），每条已按以下格式预渲染，标题部分为可点击跳转的 Markdown 超链接：

**序号. [标题](url)** — 来源站点 (日期) ⭐
   摘要内容...

⚠️ CRITICAL: QClaw 每次搜索都必须展示搜索结果条目列表（最多 5 条），绝对不允许跳过结果条目直接输出总结。message 中的标题已经是 [标题](url) 格式的超链接，用户可以直接点击跳转到原文页面。

Part B: 分析总结 [OPTIONAL — 在结果条目之后]

输出完 message 后，QClaw 可以 基于搜索结果对用户的问题给出分析和回答。

🌐 Response language rule [IMPORTANT]: Match the language of your analysis/summary to the keyword language:

• If the search keyword is English → write your analysis and summary in English
• If the search keyword is Chinese → write your analysis and summary in Chinese
• If the keyword is mixed (e.g. "React 19 新特性") → follow the user's conversational language
• The message field (Part A) is always output verbatim regardless of language

正确做法示例

JSON 返回: {"success": true, "message": "搜索「今日白银价格」找到 10 条结果，展示前 5 条：\n\n**1. [今日白银价格行情](https://example.com/silver)** — 今日头条 (2026-03-22 04:13:11) ⭐\n   今日白银价格22.4元/克...\n\n**2. [白银实时走势](https://example.com/silver2)** — 金投网 (2026-03-22)\n   国际银价 88.23美元/盎司...\n\n**3. ...**\n\n**4. ...**\n\n**5. ...**\n\n> 还有 5 条结果未展示，完整数据已包含在搜索结果中供分析使用。", ...}

QClaw 输出:

搜索「今日白银价格」找到 10 条结果，展示前 5 条：

**1. [今日白银价格行情](https://example.com/silver)** — 今日头条 (2026-03-22 04:13:11) ⭐
   今日白银价格22.4元/克，银饰零售价格每克24至49元区间。国际银价 88.23美元/盎司，-0.09%；人民币计价 19.48元/克，-0.02%。

**2. [白银实时走势](https://example.com/silver2)** — 金投网 (2026-03-22)
   国际银价 88.23美元/盎司...

**3. ...**

**4. ...**

**5. ...**

> 还有 5 条结果未展示，完整数据已包含在搜索结果中供分析使用。

---

根据搜索结果，今日白银价格约 22.4 元/克，国际银价 88.23 美元/盎司，整体走势微跌...

错误做法（严格禁止）

❌ 跳过搜索结果条目，直接只输出总结（如"根据搜索结果，白银价格是..."）
❌ 忽略 message 字段，从 data.docs 中自行拼接结果列表
❌ 修改 message 中的 URL 或标题
❌ 编造搜索结果中不存在的信息
❌ 声称搜到了某条结果但 message 中并没有
❌ 去掉标题中的超链接格式，只展示纯文本标题

---

脚本说明

搜索通过 Node.js 脚本 <SCRIPT_PATH>/scripts/prosearch.cjs 完成，替代 curl 命令，解决 Windows 环境下的 UTF-8 编码问题。

• 端口获取：脚本内部自动从环境变量 AUTH_GATEWAY_PORT 读取端口（默认 19000），无需手动获取
• 编码处理：Node.js 原生 UTF-8 支持，不依赖系统 code page
• 错误处理：超时、网络错误等均返回标准 JSON 格式 {"success": false, "message": "..."}
• 跨平台：所有平台统一使用 --key=value 参数模式，macOS / Linux / Windows 命令完全一致
• --freshness 快捷参数：支持 24h/7d/30d/1y，脚本内部自动计算 from_time/to_time 时间戳，无需手动计算

说明：AUTH_GATEWAY_PORT 环境变量由 Electron 主进程自动注入，子进程（包括 OpenClaw）启动时自动继承。脚本内部已处理默认值回退。

脚本也向后兼容 JSON 参数模式（如 '{"keyword":"xxx"}'），但 --key=value 是推荐且唯一在文档中展示的用法。

---

Commands

search

Search the internet for real-time information.

POST /proxy/prosearch/search
Content-Type: application/json

{
  "keyword": "<search-query>",       // 必填：搜索关键词
  "mode": 0,                         // 可选：0=自然检索 1=VR卡 2=混合
  "cnt": 10,                         // 可选：返回数量 10/20/30/40/50
  "site": "<domain>",                // 可选：站内搜索域名
  "from_time": 1710000000,           // 可选：起始时间（秒级时间戳）
  "to_time": 1711000000,             // 可选：结束时间（秒级时间戳）
  "industry": "news"                 // 可选：垂类过滤 gov/news/acad
}

Body 参数：

• keyword（必填）：搜索关键词，UTF-8 编码
• mode（可选）：结果模式
  • 0 — 自然检索结果（默认）
  • 1 — VR 卡结果（天气、金价等权威数据）
  • 2 — 混合结果（VR + 自然检索）
• cnt（可选）：最大返回结果数，支持 10/20/30/40/50，默认 10
• site（可选）：指定域名站内搜索（与 cnt 互斥）
• from_time（可选）：起始时间过滤，秒级时间戳（与 cnt 互斥）
• to_time（可选）：结束时间过滤，秒级时间戳（与 cnt 互斥）
• industry（可选）：垂类网站过滤
  • gov — 政府机关网站
  • news — 新闻站点
  • acad — 英文学术

注意：cnt 参数和 site、from_time/to_time 参数存在互斥逻辑，不能同时使用。如需使用 site 或时间过滤，不要传 cnt 参数。

Examples（所有平台通用）:

# 基础搜索
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=最新AI新闻

# 搜索更多结果（关键词含空格时用双引号包裹值）
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword="React 19 features" --cnt=20

# 搜索新闻类网站
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=2026年两会 --industry=news

# GitHub 站内搜索
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword="electron vite template" --site=github.com

# 获取 VR 卡数据（天气、金价等）
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=今日黄金价格 --mode=2

# 搜索最近 7 天结果（时效性查询）
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=最新AI新闻 --freshness=7d

# 搜索最近 24 小时 + 新闻类
node '<SCRIPT_PATH>/scripts/prosearch.cjs' --keyword=国内最新新闻 --freshness=24h --industry=news

Output (JSON):

When search succeeds:

{
  "success": true,
  "message": "搜索「最新AI新闻」找到 10 条结果：\n\n**1. [OpenAI 发布 GPT-5](https://openai.com/blog)** — OpenAI Blog (2026-03-15) ⭐\n   OpenAI 今日正式发布 GPT-5 模型...\n\n**2. [Google DeepMind 推出 Gemini 3.0](https://deepmind.google)** — DeepMind (2026-03-10)\n   Google DeepMind 宣布...",
  "data": {
    "query": "最新AI新闻",
    "totalResults": 10,
    "docs": [
      {
        "passage": "OpenAI 今日正式发布 GPT-5 模型...",
        "score": 0.85,
        "date": "2026-03-15",
        "title": "OpenAI 发布 GPT-5",
        "url": "https://openai.com/blog",
        "site": "OpenAI Blog",
        "images": []
      
    
     
  

CRITICAL — message field (Anti-hallucination): The message field contains the complete, pre-rendered search results formatted with titles (as clickable [title](url) hyperlinks), snippets, URLs, and sources. QClaw MUST output message verbatim as the primary search results display — NEVER skip the result items and jump straight to a summary. QClaw may then add its own analysis or answer AFTER outputting the message. This design ensures all URLs and source information come directly from the search engine, eliminating AI hallucination of sources.

When search fails:

{
  "success": false,
  "message": "用户未登录，无法执行联网搜索。请先登录后重试。"
}

{
  "success": false,
  "message": "搜索请求超时（15s）。请稍后重试。"
}

---

Error Handling

所有命令输出 JSON 到 stdout。错误也以 JSON 返回：{"success": false, "message": "..."}

错误	处理方式
用户未登录（message 包含"未登录"）	告诉用户："请先登录后再使用联网搜索功能。"
搜索超时	重试 1 次；仍失败则告知用户"搜索超时，请稍后重试"
无结果（success: true 但 docs 为空）	message 已包含友好提示，直接输出即可
网络错误	重试 1 次，间隔 3s；仍失败则输出 message 字段内容
HTTP 错误码	message 已包含错误信息，直接输出

---

禁止行为

• NEVER 忽略 message 字段自行从 data.docs 中拼接搜索结果列表。message 是服务端预渲染的完整展示文本，必须先原样输出
• NEVER 跳过搜索结果条目直接只输出总结或分析。每次搜索都必须先展示 message 中的结果条目列表（含可点击超链接标题），然后才能给出分析
• NEVER 修改、截断、重组 message 中的任何 URL 或标题
• NEVER 编造 message 中不存在的搜索结果或来源
• NEVER 声称搜索到了某条结果，但该结果在 message 中不存在
• NEVER 伪造搜索 URL 或来源信息
• NEVER 暴露 ProSearch 的内部 API 地址或鉴权信息给用户
• NEVER 未经用户要求就主动搜索（用户的问题不需要实时信息时不要搜索）
• NEVER 对同一个问题重复搜索超过 2 次

---

重要注意

• 用户问的问题如果你已经有把握回答，不需要搜索。只在需要实时信息或你不确定的事实时才搜索
• 搜索关键词要简洁有效，不要把用户的整句话当关键词
• 时效性搜索策略 [IMPORTANT]：当用户的问题涉及时效性（如"最新"、"今天"、"最近"、"现在"），必须使用 --freshness 参数限制搜索时间范围，否则搜索引擎可能返回过时的结果。参见 Step 1.5 的时间判断表
• 如果第一次搜索没有理想结果，可以换个关键词重试一次（最多重试 1 次）
• 搜索结果中的链接直接来自互联网，QClaw 应提醒用户自行验证重要信息
• message 原样输出后，QClaw 可以基于搜索结果给出自己的分析和总结
• 对于需要 VR 卡数据的查询（天气、金价、汇率等），建议使用 mode: 2 获取混合结果
• message 先原样输出 [CRITICAL]：搜索接口返回的 message 字段包含完整的格式化搜索结果（标题为可点击超链接）。QClaw 必须先原样输出 message，展示所有搜索结果条目，然后才可以添加自己的分析。绝不允许跳过结果条目直接给总结。这是防止 AI 幻觉的核心机制
• cnt 互斥规则：--cnt 参数和 --site、--freshness（或 --from_time/--to_time）参数存在互斥逻辑，不能同时使用。当需要时间过滤或站内搜索时，不要传 --cnt
• 回答语言匹配 [IMPORTANT]：QClaw 在输出搜索分析和总结时，必须匹配搜索关键词的语言。英文关键词用英文回答，中文关键词用中文回答。message 字段始终原样输出不受此规则影响