Skills perplexity-search

Name: perplexity-search
Author: openclaw

Perplexity Sonar search and answer generation through AIsa. Use when the task is specifically to call Perplexity Sonar, Sonar Pro, Sonar Reasoning Pro, or Sonar Deep Research for citation-backed web answers, analytical reasoning, or long-form research reports.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bowen-dotcom/aisa-perplexity-search-skill" ~/.claude/skills/openclaw-skills-perplexity-search && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/bowen-dotcom/aisa-perplexity-search-skill" ~/.openclaw/skills/openclaw-skills-perplexity-search && rm -rf "$T"

manifest: skills/bowen-dotcom/aisa-perplexity-search-skill/SKILL.md

Perplexity-Search

Use this skill when the user specifically wants Perplexity-powered search answers instead of structured scholar/web retrieval.

This skill covers four AIsa endpoints:

```
/perplexity/sonar
```
```
/perplexity/sonar-pro
```
```
/perplexity/sonar-reasoning-pro
```
```
/perplexity/sonar-deep-research
```

Requirements

Set
```
AISA_API_KEY
```

Use the bundled client at

{baseDir}/scripts/perplexity_search_client.py

Model Selection

Use
```
sonar
```
for fast, lightweight answers with citations
Use
```
sonar-pro
```
for stronger synthesis and comparison tasks
Use
```
sonar-reasoning-pro
```
for analytical or multi-step reasoning questions
Use
```
sonar-deep-research
```
for exhaustive reports; expect slower responses and occasional timeouts

Python Client

python3 {baseDir}/scripts/perplexity_search_client.py sonar --query "What changed in AI this week?"
python3 {baseDir}/scripts/perplexity_search_client.py sonar-pro --query "Compare coding agents with citations"
python3 {baseDir}/scripts/perplexity_search_client.py sonar-reasoning-pro --query "Analyze whether vertical AI agents can defend against general copilots"
python3 {baseDir}/scripts/perplexity_search_client.py sonar-deep-research --query "Create a deep research report on AI coding agents in 2026"

Add a system message when you want a more specific output format:

python3 {baseDir}/scripts/perplexity_search_client.py sonar-pro \
  --query "Map the top coding agent products" \
  --system "Respond in markdown with an executive summary first."

Curl Examples

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 coding agents 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 vertical AI agents can defend against general 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."}
    ]
  }'

Timeout Behavior

```
sonar-deep-research
```
uses a longer timeout and automatic retries in the bundled client
If it still times out, narrow the query or retry later
If the user wants a faster answer, fall back to
```
sonar-pro
```
or
```
sonar-reasoning-pro
```