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

Search Engine Selection Guide

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_URL environment variable must be set to the proxy URL (required, no default).
• curl command must be available in your system path.