Pular para o conteúdo principal
O OpenClaw oferece suporte à Perplexity Search API como provedor web_search. Ela retorna resultados estruturados com os campos title, url e snippet. Para compatibilidade, o OpenClaw também oferece suporte a configurações legadas do Perplexity Sonar/OpenRouter. Se você usa OPENROUTER_API_KEY, uma chave sk-or-... em plugins.entries.perplexity.config.webSearch.apiKey, ou define plugins.entries.perplexity.config.webSearch.baseUrl / model, o provedor muda para o caminho de chat-completions e retorna respostas sintetizadas por IA com citações em vez de resultados estruturados da Search API.

​
Instalar plugin

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

​
Obter uma chave de API da Perplexity

  1. Crie uma conta da Perplexity em perplexity.ai/settings/api
  2. Gere uma chave de API no painel
  3. Armazene a chave na configuração ou defina PERPLEXITY_API_KEY no ambiente do Gateway.

​
Compatibilidade com OpenRouter

Se você já usava OpenRouter para o Perplexity Sonar, mantenha provider: "perplexity" e defina OPENROUTER_API_KEY no ambiente do Gateway, ou armazene uma chave sk-or-... em plugins.entries.perplexity.config.webSearch.apiKey. Controles opcionais de compatibilidade:
  • plugins.entries.perplexity.config.webSearch.baseUrl
  • plugins.entries.perplexity.config.webSearch.model

​
Exemplos de configuração

​
Perplexity Search API nativa

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "pplx-...",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "perplexity",
      },
    },
  },
}

​
Compatibilidade com OpenRouter / Sonar

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "<openrouter-api-key>",
            baseUrl: "https://openrouter.ai/api/v1",
            model: "perplexity/sonar-pro",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "perplexity",
      },
    },
  },
}

​
Onde definir a chave

Via configuração: execute openclaw configure --section web. Isso armazena a chave em ~/.openclaw/openclaw.json em plugins.entries.perplexity.config.webSearch.apiKey. Esse campo também aceita objetos SecretRef. Via ambiente: defina PERPLEXITY_API_KEY ou OPENROUTER_API_KEY no ambiente do processo do Gateway. Para uma instalação do gateway, coloque em ~/.openclaw/.env (ou no ambiente do seu serviço). Consulte Variáveis de ambiente. Se provider: "perplexity" estiver configurado e a SecretRef da chave da Perplexity não for resolvida sem fallback de ambiente, a inicialização/recarga falha rapidamente.

​
Parâmetros da ferramenta

Estes parâmetros se aplicam ao caminho nativo da Perplexity Search API.
​
query
string
obrigatório
Consulta de pesquisa.
​
count
number
padrão:"5"
Número de resultados a retornar (1-10).
​
country
string
Código de país ISO de 2 letras (por exemplo, US, DE).
​
language
string
Código de idioma ISO 639-1 (por exemplo, en, de, fr).
​
freshness
'day' | 'week' | 'month' | 'year'
Filtro de tempo - day equivale a 24 horas.
​
date_after
string
Somente resultados publicados após esta data (YYYY-MM-DD).
​
date_before
string
Somente resultados publicados antes desta data (YYYY-MM-DD).
​
domain_filter
string[]
Array de lista de permissões/bloqueios de domínio (máx. 20).
​
max_tokens
number
padrão:"25000"
Orçamento total de conteúdo (máx. 1000000).
​
max_tokens_per_page
number
padrão:"2048"
Limite de tokens por página.
Para o caminho legado de compatibilidade Sonar/OpenRouter:
  • query, count e freshness são aceitos
  • count existe apenas para compatibilidade nesse caminho; a resposta ainda é uma única resposta sintetizada com citações, em vez de uma lista de N resultados
  • Filtros exclusivos da Search API, como country, language, date_after, date_before, domain_filter, max_tokens e max_tokens_per_page retornam erros explícitos
Exemplos: 
// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Domain filtering (allowlist)
await web_search({
  query: "climate research",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Domain filtering (denylist - prefix with -)
await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// More content extraction
await web_search({
  query: "detailed AI research",
  max_tokens: 50000,
  max_tokens_per_page: 4096,
});

​
Regras de filtro de domínio

  • Máximo de 20 domínios por filtro
  • Não é possível misturar lista de permissões e lista de bloqueios na mesma solicitação
  • Use o prefixo - para entradas de lista de bloqueios (por exemplo, ["-reddit.com"])

​
Observações

  • A Perplexity Search API retorna resultados estruturados de pesquisa na web (title, url, snippet)
  • OpenRouter ou plugins.entries.perplexity.config.webSearch.baseUrl / model explícito muda a Perplexity de volta para chat completions do Sonar por compatibilidade
  • A compatibilidade Sonar/OpenRouter retorna uma única resposta sintetizada com citações, não linhas de resultados estruturadas
  • Os resultados são armazenados em cache por 15 minutos por padrão (configurável via cacheTtlMinutes)

​
Relacionados

Web search overview

Todos os provedores e regras de detecção automática.

Brave search

Resultados estruturados com filtros de país e idioma.

Exa search

Pesquisa neural com extração de conteúdo.

Perplexity Search API docs

Guia de início rápido e referência oficiais da Perplexity Search API.