- name
- proxy-web-search
- description
- |
- metadata
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
curl --request POST \
--url "${WEB_SEARCH_PROXY_URL}/" \
--header 'Content-Type: application/json' \
--data '{
"search_query": "OpenClaw framework",
"search_engine": "search_pro_quark",
"search_intent": false,
"count": 25
}'Script Usage
A wrapper shell script is provided for convenience.
# Basic Search (defaults to search_pro_quark and 25 results)
./scripts/proxy_search.sh --query "AI development trends"
# Advanced Search
./scripts/proxy_search.sh \
--query "latest open source LLMs" \
--engine "search_pro_sogou" \
--count 50 \
--intent \
--recency "oneWeek"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 |
|---|---|---|---|---|
search_query | string | ✅ | - | Search content, recommended ≤70 chars |
search_engine | 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 |
|---|---|
search_pro_quark | Quark search, tailored for specific advanced scenarios (Default) |
search_std | 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.
{
"id": "task-id",
"created": 1704067200,
"request_id": "request-id",
"search_intent": [
{
"query": "original query",
"intent": "SEARCH_ALL",
"keywords": "rewritten keywords"
}
],
"search_result": [
{
"title": "title",
"content": "content summary",
"link": "result link",
"media": "site name",
"icon": "site icon",
"refer": "reference number",
"publish_date": "publish date"
}
]
}Environment Requirements
- OpenClaw Manager must be running with the Web Search Proxy enabled.
WEB_SEARCH_PROXY_URLenvironment variable must be set to the proxy URL (required, no default).curlcommand must be available in your system path.