Pular para o conteúdo principal
O Plugin Perplexity fornece recursos de pesquisa na web por meio da API de Pesquisa Perplexity ou do Perplexity Sonar via OpenRouter.
Esta página é a configuração do provedor Perplexity. Para a ferramenta Perplexity (como o agente a usa), consulte ferramenta Perplexity.
PropriedadeValor
TipoProvedor de pesquisa na web (não é um provedor de modelo)
AutenticaçãoPERPLEXITY_API_KEY (direto) ou OPENROUTER_API_KEY (via OpenRouter)
Caminho de configuraçãoplugins.entries.perplexity.config.webSearch.apiKey

​
Instalar Plugin

Instale o Plugin oficial e reinicie o Gateway: 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​
Primeiros passos

1

Set the API key

Execute o fluxo interativo de configuração de pesquisa na web:
openclaw configure --section web
Ou defina a chave diretamente:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

Start searching

O agente usará automaticamente o Perplexity para pesquisas na web assim que a chave estiver configurada. Nenhuma etapa adicional é necessária.

​
Modos de pesquisa

O Plugin seleciona automaticamente o transporte com base no prefixo da chave de API:
Quando sua chave começa com pplx-, o OpenClaw usa a API de Pesquisa Perplexity nativa. Esse transporte retorna resultados estruturados e oferece suporte a filtros de domínio, idioma e data (consulte as opções de filtragem abaixo).
Prefixo da chaveTransporteRecursos
pplx-API de Pesquisa Perplexity nativaResultados estruturados, filtros de domínio/idioma/data
sk-or-OpenRouter (Sonar)Respostas sintetizadas por IA com citações

​
Filtragem da API nativa

As opções de filtragem só estão disponíveis ao usar a API Perplexity nativa (chave pplx-). Pesquisas via OpenRouter/Sonar não oferecem suporte a esses parâmetros.
Ao usar a API Perplexity nativa, as pesquisas oferecem suporte aos seguintes filtros:
FiltroDescriçãoExemplo
PaísCódigo de país de 2 letrasus, de, jp
IdiomaCódigo de idioma ISO 639-1en, fr, zh
Intervalo de datasJanela de recênciaday, week, month, year
Filtros de domínioLista de permissões ou de bloqueio (máx. 20 domínios)example.com
Orçamento de conteúdoLimites de tokens por resposta / por páginamax_tokens, max_tokens_per_page

​
Configuração avançada

Se o Gateway do OpenClaw for executado como um daemon (launchd/systemd), garanta que PERPLEXITY_API_KEY esteja disponível para esse processo.
Uma chave exportada apenas em um shell interativo não ficará visível para um daemon launchd/systemd, a menos que esse ambiente seja importado explicitamente. Defina a chave em ~/.openclaw/.env ou via env.shellEnv para garantir que o processo do gateway possa lê-la.
Se preferir rotear pesquisas do Perplexity por meio do OpenRouter, defina uma OPENROUTER_API_KEY (prefixo sk-or-) em vez de uma chave Perplexity nativa. O OpenClaw detectará o prefixo e alternará para o transporte Sonar automaticamente.
O transporte OpenRouter é útil se você já tem uma conta OpenRouter e quer faturamento consolidado entre vários provedores.

​
Relacionados

Perplexity search tool

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

Configuration reference

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