Skip to main content

​
Perplexity Sonar

Clawdia can use Perplexity Sonar for the web_search tool. You can connect through Perplexity’s direct API or via OpenRouter.

​
API options

​
Perplexity (direct)

​
OpenRouter (alternative)

​
Config example

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
          model: "perplexity/sonar-pro"
        }
      }
    }
  }
}

​
Switching from Brave

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai"
        }
      }
    }
  }
}
If both PERPLEXITY_API_KEY and OPENROUTER_API_KEY are set, set tools.web.search.perplexity.baseUrl (or tools.web.search.perplexity.apiKey) to disambiguate. If no base URL is set, Clawdia chooses a default based on the API key source:
  • PERPLEXITY_API_KEY or pplx-... → direct Perplexity (https://api.perplexity.ai)
  • OPENROUTER_API_KEY or sk-or-... → OpenRouter (https://openrouter.ai/api/v1)
  • Unknown key formats → OpenRouter (safe fallback)

​
Models

  • perplexity/sonar — fast Q&A with web search
  • perplexity/sonar-pro (default) — multi-step reasoning + web search
  • perplexity/sonar-reasoning-pro — deep research
See Web tools for the full web_search configuration.