Skip to main content
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.

​
Instalar o plugin

​
Primeiros passos

1

Definir a chave da API

Ou defina a chave diretamente:
Uma chave exportada como PERPLEXITY_API_KEY ou OPENROUTER_API_KEY no ambiente do Gateway também funciona.
2

Começar a pesquisar

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:

​
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.
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

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 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

Ferramenta de pesquisa do Perplexity

Como o agente executa pesquisas do Perplexity e interpreta os resultados.

Referência de configuração

Referência completa de configuração, incluindo entradas de plugins.