--- name: openclaw-search description: "Intelligent search for agents. Multi-source retrieval across web, scholar, Tavily, and Perplexity Sonar models." homepage: https://openclaw.ai metadata: {"openclaw":{"emoji":"🔎","requires":{"bins":["curl","python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}} ---

OpenClaw Search

Intelligent search for autonomous agents, powered by AIsa.

One API key gives you:

• Structured web search
• Scholar search
• Hybrid scholar search
• Tavily search and extraction tools
• Perplexity Sonar answer-generation endpoints with citations

What This Skill Is Best For

Fast web lookup

Search the latest AI infrastructure launches and summarize the top sources.

Scholar-backed research

Find recent papers on multimodal reasoning from 2024 onward.

Citation-rich answers

Use Sonar Pro to answer which open-source agent frameworks are gaining traction and cite sources.

Deep research reports

Use Sonar Deep Research to produce a thorough market map of AI browser agents.

Quick Start

export AISA_API_KEY="your-key"

Search APIs

Web Search

curl -X POST "https://api.aisa.one/apis/v1/scholar/search/web?query=AI+frameworks&max_num_results=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

Scholar Search

curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar?query=transformer+models&max_num_results=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar?query=LLM&max_num_results=10&as_ylo=2024&as_yhi=2025" \
  -H "Authorization: Bearer $AISA_API_KEY"

Hybrid Scholar Search

curl -X POST "https://api.aisa.one/apis/v1/scholar/search/smart?query=machine+learning+optimization&max_num_results=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

Perplexity Sonar APIs

The deprecated /search/full and /search/smart nodes have been removed from this skill.

The replacement flow is the Perplexity API family:

| Endpoint | Use case | |----------|----------| | /perplexity/sonar | Lightweight, cost-effective search answers with citations | | /perplexity/sonar-pro | Better for complex queries and multi-step follow-ups | | /perplexity/sonar-reasoning-pro | Stronger analytical reasoning with web search | | /perplexity/sonar-deep-research | Exhaustive research and long-form reports |

These descriptions are based on the AIsa docs:

• Sonar
• Sonar Pro
• Sonar Reasoning Pro
• Sonar Deep Research

Sonar

curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sonar",
    "messages": [
      {"role": "user", "content": "What changed in the AI agent ecosystem this week?"}
    ]
  }'

Sonar Pro

curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-pro" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sonar-pro",
    "messages": [
      {"role": "user", "content": "Compare the top browser-use agent frameworks and cite the key differences."}
    ]
  }'

Sonar Reasoning Pro

curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-reasoning-pro" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sonar-reasoning-pro",
    "messages": [
      {"role": "user", "content": "Analyze whether small vertical AI agents can defend against general-purpose copilots."}
    ]
  }'

Sonar Deep Research

curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sonar-deep-research",
    "messages": [
      {"role": "user", "content": "Create a deep research report on AI coding agents in 2026, including product categories, pricing, and risks."}
    ]
  }'

Tavily APIs

curl -X POST "https://api.aisa.one/apis/v1/tavily/search" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"latest AI developments"}'

curl -X POST "https://api.aisa.one/apis/v1/tavily/extract" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com/article"]}'

curl -X POST "https://api.aisa.one/apis/v1/tavily/crawl" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","max_depth":2}'

curl -X POST "https://api.aisa.one/apis/v1/tavily/map" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

Python Client

# Structured search
python3 {baseDir}/scripts/search_client.py web --query "latest AI news" --count 10
python3 {baseDir}/scripts/search_client.py scholar --query "transformer architecture" --count 10
python3 {baseDir}/scripts/search_client.py smart --query "autonomous agents" --count 10

# Perplexity Sonar family
python3 {baseDir}/scripts/search_client.py sonar --query "Summarize this week's AI launches"
python3 {baseDir}/scripts/search_client.py sonar-pro --query "Compare AI agent frameworks with citations"
python3 {baseDir}/scripts/search_client.py sonar-reasoning-pro --query "Analyze the defensibility of AI copilots"
python3 {baseDir}/scripts/search_client.py sonar-deep-research --query "Write a deep research report on AI browser agents"

# Optional system instruction
python3 {baseDir}/scripts/search_client.py sonar-pro \
  --query "Map the top coding agent products" \
  --system "Respond in markdown with a short executive summary first."

# Tavily utilities
python3 {baseDir}/scripts/search_client.py tavily-search --query "AI developments"
python3 {baseDir}/scripts/search_client.py tavily-extract --urls "https://example.com/article"

# Multi-source retrieval
python3 {baseDir}/scripts/search_client.py verity --query "Is quantum computing ready for enterprise?"

API Reference

| Endpoint | Method | Description | |----------|--------|-------------| | /scholar/search/web | POST | Web search with structured results | | /scholar/search/scholar | POST | Academic paper search | | /scholar/search/smart | POST | Hybrid scholar search | | /scholar/explain | POST | Generate result explanations | | /perplexity/sonar | POST | Lightweight search answers with citations | | /perplexity/sonar-pro | POST | Advanced search answers for complex tasks | | /perplexity/sonar-reasoning-pro | POST | Analytical reasoning with web search | | /perplexity/sonar-deep-research | POST | Exhaustive research reports | | /tavily/search | POST | Tavily search integration | | /tavily/extract | POST | Extract content from URLs | | /tavily/crawl | POST | Crawl web pages | | /tavily/map | POST | Generate site maps |

Parameters

Scholar search query parameters

| Parameter | Type | Description | |-----------|------|-------------| | query | string | Search query | | max_num_results | integer | Max results (default 10) | | as_ylo | integer | Year lower bound | | as_yhi | integer | Year upper bound |

Perplexity request body

This skill sends a minimal OpenAI-style payload:

{
  "model": "sonar-pro",
  "messages": [
    {"role": "system", "content": "Optional system instruction"},

...