---
read_when:
- Você quer configurar o Perplexity como provedor de pesquisa na web
- Você precisa da chave da API do Perplexity ou da configuração do proxy do OpenRouter
summary: Configuração do provedor de pesquisa na web Perplexity (chave de API, modos de pesquisa, filtragem)
title: Perplexity
x-i18n:
generated_at: "2026-07-12T00:20:33Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: ea76a5cb7befce95756e9bcc8f9c1637fac87711d02d8a486ec2a1b9f51b73dc
source_path: providers/perplexity-provider.md
workflow: 16
---
O plugin Perplexity registra um provedor `web_search` com dois transportes: a
API nativa de Pesquisa do Perplexity (resultados estruturados com filtros) e as
conclusões de chat do Perplexity Sonar, diretamente ou via OpenRouter (respostas
sintetizadas por IA com citações).
Esta página aborda a configuração do **provedor** Perplexity. Para a **ferramenta** Perplexity (como o agente a utiliza), consulte [Pesquisa do Perplexity](/pt-BR/tools/perplexity-search).
| Propriedade | Valor |
| ------------------- | ---------------------------------------------------------------------- |
| Tipo | Provedor de pesquisa na web (não é um provedor de modelos) |
| Autenticação | `PERPLEXITY_API_KEY` (nativa) ou `OPENROUTER_API_KEY` (via OpenRouter) |
| Caminho de configuração | `plugins.entries.perplexity.config.webSearch.apiKey` |
| Substituições | `plugins.entries.perplexity.config.webSearch.baseUrl` / `.model` |
| Obter uma chave | [perplexity.ai/settings/api](https://www.perplexity.ai/settings/api) |
## Instalar o plugin
```bash
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart
```
## Primeiros passos
```bash
openclaw configure --section web
```
Ou defina a chave diretamente:
```bash
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
```
Uma chave exportada como `PERPLEXITY_API_KEY` ou `OPENROUTER_API_KEY` no
ambiente do Gateway também funciona.
O `web_search` detecta automaticamente o Perplexity quando a chave dele é a
credencial de pesquisa disponível; nenhuma configuração adicional é
necessária. Para fixar explicitamente o provedor:
```bash
openclaw config set tools.web.search.provider perplexity
```
## Modos de pesquisa
O plugin determina o transporte nesta ordem:
1. Se `webSearch.baseUrl` ou `webSearch.model` estiver definido: sempre encaminha pelas conclusões de chat do Sonar nesse endpoint, independentemente do tipo de chave.
2. Caso contrário, a origem da chave determina o endpoint: o prefixo de uma chave configurada seleciona o transporte (a configuração tem precedência sobre as variáveis de ambiente); uma chave de ambiente usa diretamente o endpoint correspondente.
| Prefixo da chave | Transporte | Recursos |
| ---------------- | ---------------------------------------------------------- | ---------------------------------------------------------- |
| `pplx-` | API nativa de Pesquisa do Perplexity (`https://api.perplexity.ai`) | Resultados estruturados e filtros de domínio, idioma e data |
| `sk-or-` | OpenRouter (`https://openrouter.ai/api/v1`), modelo Sonar | Respostas sintetizadas por IA com citações |
Uma chave configurada com qualquer outro prefixo também usa a API nativa de
Pesquisa. O caminho de conclusões de chat usa por padrão o modelo
`perplexity/sonar-pro`; substitua-o com
`plugins.entries.perplexity.config.webSearch.model`.
## Filtragem da API nativa
| Filtro | Descrição | Transporte |
| ------------------------------------ | --------------------------------------------------------------------------- | ---------------- |
| `count` | Resultados por pesquisa, de 1 a 10 (padrão: 5) | Somente nativo |
| `freshness` | Intervalo de atualidade: `day`, `week`, `month`, `year` | Ambos |
| `country` | Código de país de 2 letras (`us`, `de`, `jp`) | Somente nativo |
| `language` | Código de idioma ISO 639-1 (`en`, `fr`, `zh`) | Somente nativo |
| `date_after` / `date_before` | Intervalo de datas de publicação no formato `YYYY-MM-DD` | Somente nativo |
| `domain_filter` | Máximo de 20 domínios; lista de permissões ou lista de bloqueios com prefixo `-`, nunca combinadas | Somente nativo |
| `max_tokens` / `max_tokens_per_page` | Orçamento de conteúdo para todos os resultados / por página | Somente nativo |
Os filtros exclusivos do transporte nativo retornam um erro descritivo no
caminho de conclusões de chat. `freshness` não pode ser combinado com
`date_after`/`date_before`.
## Configuração avançada
Uma chave exportada somente em um shell interativo não fica visível para um
daemon do Gateway executado por launchd/systemd, a menos que esse ambiente
seja importado explicitamente. Defina a chave em `~/.openclaw/.env` ou via
`env.shellEnv` para que o processo do Gateway possa lê-la. Consulte
[Variáveis de ambiente](/pt-BR/help/environment) para ver a ordem completa de
precedência.
Para encaminhar pesquisas do Perplexity pelo OpenRouter, defina uma
`OPENROUTER_API_KEY` (prefixo `sk-or-`) em vez de uma chave nativa do
Perplexity. O OpenClaw detecta a chave e muda automaticamente para o
transporte Sonar. Isso é útil se você já configurou o faturamento do
OpenRouter e deseja consolidar os provedores nele.
## Relacionados
Como o agente executa pesquisas do Perplexity e interpreta os resultados.
Referência completa de configuração, incluindo entradas de plugins.