Pular para o conteúdo principal

Perplexity (Provedor de Pesquisa na Web)

O plugin Perplexity fornece recursos de pesquisa na web por meio da API de Search do Perplexity ou do Perplexity Sonar via OpenRouter.
Esta página cobre a configuração do provedor Perplexity. Para a ferramenta Perplexity (como o agente a utiliza), consulte Perplexity tool.
  • Tipo: provedor de pesquisa na web (não é um provedor de modelo)
  • Autenticação: PERPLEXITY_API_KEY (direto) ou OPENROUTER_API_KEY (via OpenRouter)
  • Caminho de configuração: plugins.entries.perplexity.config.webSearch.apiKey

Início rápido

  1. Defina a chave de API:
openclaw configure --section web
Ou defina-a diretamente:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
  1. O agente usará automaticamente o Perplexity para pesquisas na web quando estiver configurado.

Modos de pesquisa

O plugin seleciona automaticamente o transporte com base no prefixo da chave de API:
Prefixo da chaveTransporteRecursos
pplx-API nativa de Search do PerplexityResultados estruturados, filtros de domínio/idioma/data
sk-or-OpenRouter (Sonar)Respostas sintetizadas por IA com citações

Filtragem da API nativa

Ao usar a API nativa do Perplexity (pplx- key), as pesquisas têm suporte a:
  • País: código de país de 2 letras
  • Idioma: código de idioma ISO 639-1
  • Intervalo de datas: dia, semana, mês, ano
  • Filtros de domínio: allowlist/denylist (máximo de 20 domínios)
  • Orçamento de conteúdo: max_tokens, max_tokens_per_page

Observação sobre o ambiente

Se o Gateway estiver em execução como daemon (launchd/systemd), certifique-se de que PERPLEXITY_API_KEY esteja disponível para esse processo (por exemplo, em ~/.openclaw/.env ou via env.shellEnv).