Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

O Plugin Perplexity fornece recursos de busca na web por meio da API de Busca do 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 busca na web (não é um provedor de modelo)
AuthPERPLEXITY_API_KEY (direto) ou OPENROUTER_API_KEY (via OpenRouter)
Caminho de configuraçãoplugins.entries.perplexity.config.webSearch.apiKey

​
Introdução

1

Set the API key

Execute o fluxo interativo de configuração de busca 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 buscas na web assim que a chave estiver configurada. Nenhuma etapa adicional é necessária.

​
Modos de busca

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 Busca Perplexity nativa. Esse transporte retorna resultados estruturados e oferece suporte a filtros de domínio, idioma e data (veja as opções de filtragem abaixo).
Prefixo da chaveTransporteRecursos
pplx-API de Busca 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-). Buscas via OpenRouter/Sonar não oferecem suporte a esses parâmetros.
Ao usar a API Perplexity nativa, as buscas 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 bloqueios (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 OpenClaw Gateway for executado como daemon (launchd/systemd), certifique-se de que PERPLEXITY_API_KEY esteja disponível para esse processo.
Uma chave definida apenas em ~/.profile não ficará visível para um daemon launchd/systemd, a menos que esse ambiente seja explicitamente importado. Defina a chave em ~/.openclaw/.env ou via env.shellEnv para garantir que o processo do gateway consiga lê-la.
Se você preferir encaminhar buscas do Perplexity pelo 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 deseja cobrança consolidada entre vários provedores.

​
Relacionado

Perplexity search tool

Como o agente invoca buscas do Perplexity e interpreta resultados.

Configuration reference

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