OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Perplexity

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

Propriedade Valor
Tipo Provedor de pesquisa na web (não é um provedor de modelos)
Autenticação PERPLEXITY_API_KEY (nativa) ou OPENROUTER_API_KEY (via OpenRouter)
Caminho de configuração plugins.entries.perplexity.config.webSearch.apiKey
Substituições plugins.entries.perplexity.config.webSearch.baseUrl / .model
Obter uma chave perplexity.ai/settings/api

Instalar o plugin

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

Primeiros passos

  • Definir a chave da API

    bash
    openclaw configure --section web

    Ou defina a chave diretamente:

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

    Uma chave exportada como PERPLEXITY_API_KEY ou OPENROUTER_API_KEY no ambiente do Gateway também funciona.

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

    bash
    openclaw config set tools.web.search.provider perplexity

    • 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.
    Prefixo da chave Transporte Recursos
    pplx- API nativa de Pesquisa do Perplexity (https://api.perplexity.ai) Resultados estruturados e filtros de domínio, idioma e data
    sk-or- OpenRouter (https://openrouter.ai/api/v1), modelo Sonar Respostas sintetizadas por IA com citações

    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

    Filtro Descrição Transporte
    count Resultados por pesquisa, de 1 a 10 (padrão: 5) Somente nativo
    freshness Intervalo de atualidade: day, week, month, year Ambos
    country Código de país de 2 letras (us, de, jp) Somente nativo
    language Código de idioma ISO 639-1 (en, fr, zh) Somente nativo
    date_after / date_before Intervalo de datas de publicação no formato YYYY-MM-DD Somente nativo
    domain_filter Máximo de 20 domínios; lista de permissões ou lista de bloqueios com prefixo -, nunca combinadas Somente nativo
    max_tokens / max_tokens_per_page Orçamento de conteúdo para todos os resultados / por página Somente nativo

    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

    Variável de ambiente para processos daemon
    Configuração do proxy OpenRouter

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

    On this page