Perplexity Web Search

# Web Search Skill

Web search via Perplexity (default: sonar) and URL content fetching. Sonar-pro is optional for deeper analysis.

## Credentials

This skill uses the Perplexity key configured in your OpenClaw setup. No shared or third-party keys are used.

If your environment is not already configured, set `PERPLEXITY_API_KEY` or configure the key in OpenClaw config.

**Recommended default (cost-effective):**
```json5
{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "<your-perplexity-api-key>",
          baseUrl: "https://api.perplexity.ai",
          model: "sonar"
        }
      }
    }
  }
}
```

**Optional deep mode (higher quality, higher cost):**
```json5
{
  tools: {
    web: {
      search: {
        perplexity: {
          model: "sonar-pro"
        }
      }
    }
  }
}
```

Use `sonar-pro` only when you explicitly need deeper analysis.

Get your API key at: https://www.perplexity.ai/settings/api

## Data Handling

- All search queries are sent to Perplexity's API (`https://api.perplexity.ai`)
- `web_fetch` fetched page contents are processed locally by OpenClaw (not sent to Perplexity)
- This instruction-only skill does not persist data by itself; query handling/retention is governed by OpenClaw + Perplexity policies
- Search queries are sent to Perplexity; do not include secrets or private data in queries
- Your own Perplexity API key and account terms apply

## web_search

Search the web. Returns AI-synthesized answers with citations.

Parameters:
- `query` (required) — search query
- `count` (1-10) — number of results
- `country` — 2-letter code: TR, US, DE, ALL
- `search_lang` — result language: tr, en, de, fr
- `freshness` — time filter: pd (day), pw (week), pm (month), py (year)

### Including Social Platform Results

For market research or user feedback queries, add social platform names naturally to the query. This makes Perplexity include results from Reddit, Twitter, Quora etc. a...