Proxy Web Search
Web search via the OpenClaw Manager Web Search Proxy. The Manager handles API key injection from encrypted storage automatically — no manual key configuration needed.
The proxy URL is configured via the WEB_SEARCH_PROXY_URL environment variable (required). If not set, the skill will not be available.
Defaults to using the search_pro_quark engine with 25 results.
Quick Start
Basic cURL Usage
CODEBLOCK0
Script Usage
A wrapper shell script is provided for convenience.
CODEBLOCK1
Authentication
No authentication required — the proxy reads API keys internally from the Manager's encrypted secrets store.
API Parameter Reference
| Parameter | Type | Required | Default | Description |
|---|
| INLINECODE2 | string | ✅ | - | Search content, recommended ≤70 chars |
| INLINECODE3 |
enum | - |
search_pro_quark |
search_std /
search_pro /
search_pro_sogou /
search_pro_quark |
|
search_intent | boolean | - |
false | Enable search intent recognition |
|
count | integer | - |
25 | Result count, range 1-50 |
|
search_domain_filter | string | - | - | Whitelist domain filter |
|
search_recency_filter | enum | - |
noLimit |
oneDay /
oneWeek /
oneMonth /
oneYear /
noLimit |
|
content_size | enum | - |
medium |
medium (summary) /
high (detailed) |
Search Engine Selection Guide
| Engine | Use Case |
|---|
| INLINECODE25 | Quark search, tailored for specific advanced scenarios (Default) |
| INLINECODE26 |
Basic search, regular Q&A |
|
search_pro | Advanced search, need more accurate results |
|
search_pro_sogou | Sogou search, China domestic content |
Response Structure
The proxy returns JSON directly.
CODEBLOCK2
Environment Requirements
- - OpenClaw Manager must be running with the Web Search Proxy enabled.
- INLINECODE29 environment variable must be set to the proxy URL (required, no default).
- INLINECODE30 command must be available in your system path.
代理网络搜索
通过OpenClaw管理器网络搜索代理进行网络搜索。管理器自动从加密存储中注入API密钥——无需手动配置密钥。
代理URL通过WEBSEARCHPROXY_URL环境变量配置（必需）。如果未设置，该技能将不可用。
默认使用searchproquark引擎，返回25条结果。
快速开始
基础cURL用法
bash
curl --request POST \
--url ${WEBSEARCHPROXY_URL}/ \
--header Content-Type: application/json \
--data {
search_query: OpenClaw framework,
searchengine: searchpro_quark,
search_intent: false,
count: 25
}
脚本用法
为方便使用，提供了一个封装shell脚本。
bash
基础搜索（默认使用searchproquark和25条结果）
./scripts/proxy_search.sh --query AI发展趋势
高级搜索
./scripts/proxy_search.sh \
--query 最新开源大语言模型 \
--engine search
prosogou \
--count 50 \
--intent \
--recency oneWeek
身份验证
无需身份验证——代理从管理器的加密密钥存储中内部读取API密钥。
API参数参考
| 参数 | 类型 | 必需 | 默认值 | 描述 |
|---|
| searchquery | 字符串 | ✅ | - | 搜索内容，建议≤70个字符 |
| searchengine |
枚举 | - | search
proquark | search
std / searchpro / search
prosogou / search
proquark |
| search_intent | 布尔值 | - | false | 启用搜索意图识别 |
| count | 整数 | - | 25 | 结果数量，范围1-50 |
| search
domainfilter | 字符串 | - | - | 白名单域名过滤 |
| search
recencyfilter | 枚举 | - | noLimit | oneDay / oneWeek / oneMonth / oneYear / noLimit |
| content_size | 枚举 | - | medium | medium（摘要）/ high（详细） |
搜索引擎选择指南
| 引擎 | 使用场景 |
|---|
| searchproquark | 夸克搜索，针对特定高级场景定制（默认） |
| search_std |
基础搜索，常规问答 |
| search_pro | 高级搜索，需要更精确的结果 |
| search
prosogou | 搜狗搜索，中国国内内容 |
响应结构
代理直接返回JSON。
json
{
id: 任务ID,
created: 1704067200,
request_id: 请求ID,
search_intent: [
{
query: 原始查询,
intent: SEARCH_ALL,
keywords: 重写后的关键词
}
],
search_result: [
{
title: 标题,
content: 内容摘要,
link: 结果链接,
media: 站点名称,
icon: 站点图标,
refer: 参考编号,
publish_date: 发布日期
}
]
}
环境要求
- - OpenClaw管理器必须运行并启用网络搜索代理。
- WEBSEARCHPROXY_URL环境变量必须设置为代理URL（必需，无默认值）。
- 系统路径中必须可用curl命令。
