knownasnaffy Permission Setup Review
python scripts/_perms_marker.py is an optional setup helper for the Proxy Web Search skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.
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.