English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Providers

Perplexity

O Plugin Perplexity fornece recursos de pesquisa na web por meio da API de Pesquisa Perplexity ou do Perplexity Sonar via OpenRouter.

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

Instalar Plugin

Instale o Plugin oficial e reinicie o Gateway:

bash
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Primeiros passos

  • Set the API key

    Execute o fluxo interativo de configuração de pesquisa na web:

    bash
    openclaw configure --section web

    Ou defina a chave diretamente:

    bash
    openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"

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

    Native Perplexity API (pplx-)

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

    OpenRouter / Sonar (sk-or-)

    Quando sua chave começa com sk-or-, o OpenClaw roteia por meio do OpenRouter usando o modelo Perplexity Sonar. Esse transporte retorna respostas sintetizadas por IA com citações.

    Prefixo da chave Transporte Recursos
    pplx- API de Pesquisa Perplexity nativa Resultados 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 Perplexity nativa, as pesquisas oferecem suporte aos seguintes filtros:

    Filtro Descrição Exemplo
    País Código de país de 2 letras us, de, jp
    Idioma Código de idioma ISO 639-1 en, fr, zh
    Intervalo de datas Janela de recência day, week, month, year
    Filtros de domínio Lista de permissões ou de bloqueio (máx. 20 domínios) example.com
    Orçamento de conteúdo Limites de tokens por resposta / por página max_tokens, max_tokens_per_page

    Configuração avançada

    Environment variable for daemon processes

    Se o Gateway do OpenClaw for executado como um daemon (launchd/systemd), garanta que PERPLEXITY_API_KEY esteja disponível para esse processo.

    OpenRouter proxy setup

    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.

    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.
    Was this useful?
    On this page

    On this page