Skip to main content
O Plugin Parallel fornece dois provedores de web_search da Parallel, ambos retornando trechos classificados e otimizados para LLM a partir de um índice da web criado para agentes de IA: Defina tools.web.search.provider como parallel-free ou parallel para selecionar um deles explicitamente; nenhum dos dois é detectado automaticamente.
Os modelos diretos de Responses da OpenAI (api: "openai-responses", provedor openai, URL base oficial da API) usam automaticamente a pesquisa nativa na web hospedada pela OpenAI quando tools.web.search.provider não está definido, está vazio, é "auto" ou "openai" — portanto, ignoram a Parallel por padrão. Defina tools.web.search.provider como parallel-free ou parallel para encaminhá-los pela Parallel. Consulte a visão geral da pesquisa na web.

​
Instalar o Plugin

​
Chave de API (provedor pago)

parallel-free não precisa de chave, mas ainda deve ser selecionado explicitamente. O provedor pago parallel precisa de uma chave de API:
1

Criar uma conta

Cadastre-se em platform.parallel.ai e gere uma chave de API no seu painel.
2

Armazenar a chave

Defina PARALLEL_API_KEY no ambiente do Gateway ou configure por meio de:

​
Configuração

Alternativa por variável de ambiente: defina PARALLEL_API_KEY no ambiente do Gateway. Para uma instalação do Gateway, coloque-a em ~/.openclaw/.env.

​
Substituição da URL base

Aplica-se apenas ao provedor pago parallel; parallel-free sempre usa https://search.parallel.ai/mcp e ignora essa configuração. Defina plugins.entries.parallel.config.webSearch.baseUrl para encaminhar solicitações pagas por um proxy compatível ou endpoint alternativo (por exemplo, o Cloudflare AI Gateway). O OpenClaw normaliza hosts sem esquema acrescentando https:// no início e acrescenta /v1/search, a menos que o caminho já termine assim. O endpoint resolvido faz parte da chave do cache de pesquisa, portanto os resultados de endpoints diferentes nunca são compartilhados.

​
Parâmetros da ferramenta

Ambos os provedores expõem o formato de pesquisa nativo da Parallel para que o modelo preencha um objetivo em linguagem natural e algumas consultas curtas por palavras-chave — a combinação que a Parallel recomenda para obter os melhores resultados.
​
string
obrigatório
Descrição em linguagem natural da pergunta ou do objetivo subjacente (máximo de 5.000 caracteres). Deve ser autossuficiente.
​
string[]
obrigatório
Consultas de pesquisa concisas por palavras-chave, com 3 a 6 palavras cada (de 1 a 5 entradas, máximo de 200 caracteres cada). Forneça de 2 a 3 consultas variadas para obter os melhores resultados.
​
number
Resultados a retornar (1 a 40).
​
string
ID de sessão opcional da Parallel proveniente do sessionId de um resultado anterior. Passe-o em pesquisas subsequentes da mesma tarefa para que a Parallel agrupe chamadas relacionadas e melhore os resultados posteriores. Máximo de 1.000 caracteres em parallel; o Search MCP gratuito parallel-free limita-o a 100. Um ID acima do limite é descartado (pago) ou um novo é gerado (gratuito).
​
string
Identificador opcional do modelo que faz a chamada (por exemplo, claude-opus-4-7, gpt-5.6-sol), com no máximo 100 caracteres. Permite que a Parallel adapte as configurações padrão às capacidades do seu modelo. Passe o identificador exato do modelo ativo; não o abrevie para um alias de família.

​
Observações

  • A Parallel classifica e compacta os resultados visando sua utilidade para o raciocínio de LLMs, não para cliques humanos; espere trechos densos por resultado, em vez do conteúdo completo das páginas.
  • Os trechos dos resultados são retornados como o array excerpts e também são unidos em description para manter a compatibilidade com o contrato genérico de web_search.
  • Ambos os provedores retornam um session_id; o OpenClaw o expõe como sessionId na carga útil da ferramenta para que os chamadores possam agrupar pesquisas subsequentes. Um ID de sessão gerado pela Parallel (que o chamador não forneceu) é excluído da entrada do cache, pois tarefas não relacionadas com consultas idênticas não devem herdá-lo.
  • searchId, warnings e usage da Parallel são repassados quando estão presentes.
  • O OpenClaw sempre encaminha uma contagem de resultados resolvida à Parallel como advanced_settings.max_results (parallel) ou aplica count no lado do cliente após a resposta de tamanho fixo da Parallel (parallel-free). O argumento count do chamador tem prioridade, seguido por tools.web.search.maxResults; caso contrário, é usado o padrão genérico de web_search do OpenClaw (5) — o padrão da própria API da Parallel é 10.
  • Os resultados são armazenados em cache por 15 minutos por padrão (cacheTtlMinutes).
  • parallel-free gera um novo session_id por chamada por meio de seu handshake MCP quando o chamador não fornece um; parallel não o define nesse caso.

​
Relacionados