Skip to main content
O OpenClaw oferece suporte ao SearXNG como um provedor de web_search auto-hospedado e sem necessidade de chave. O SearXNG é um mecanismo de metabusca de código aberto que agrega resultados do Google, Bing, DuckDuckGo e de outras fontes. Vantagens:
  • Gratuito e ilimitado — não requer chave de API nem assinatura comercial
  • Privacidade / isolamento de rede — as consultas nunca saem da sua rede
  • Funciona em qualquer lugar — sem restrições regionais de APIs de pesquisa comerciais

​
Configuração

1

Instale o plugin

2

Execute uma instância do SearXNG

Ou use qualquer implantação existente do SearXNG à qual você tenha acesso. Consulte a documentação do SearXNG para saber como configurá-lo em produção.
3

Configure

Ou defina a variável de ambiente e permita que a detecção automática a encontre:

​
Configuração

Configurações no nível do plugin para a instância do SearXNG:
baseUrl também aceita um objeto SecretRef (por exemplo, { source: "env", id: "SEARXNG_BASE_URL" }).

​
Variável de ambiente

Defina SEARXNG_BASE_URL como alternativa à configuração:
Ordem de resolução: a string baseUrl configurada, depois uma SecretRef de ambiente embutida em baseUrl e, por fim, SEARXNG_BASE_URL. Quando nenhum dos caminhos de configuração estiver definido, SEARXNG_BASE_URL estiver presente e nenhum provedor tiver sido escolhido explicitamente, a detecção automática selecionará o SearXNG.

​
Referência de configuração do plugin

A chamada da ferramenta web_search também aceita count (de 1 a 10 resultados), categories e language como substituições específicas de cada chamada.

​
Observações

  • API JSON — usa o endpoint nativo format=json do SearXNG, não a extração de conteúdo de HTML
  • URLs de resultados de imagens — os resultados da categoria de imagens incluem img_src quando o SearXNG retorna uma URL direta da imagem
  • Sem chave de API — funciona imediatamente com qualquer instância do SearXNG
  • Validação da URL base — baseUrl deve ser uma URL http:// ou https:// válida
  • Proteção de rede — URLs base http:// devem apontar para um host privado confiável ou de local loopback (hosts públicos devem usar https://); URLs base https:// que sejam resolvidas para um endereço privado/interno recebem a mesma permissão de auto-hospedagem, enquanto URLs base https:// resolvidas publicamente mantêm proteção rigorosa contra SSRF
  • Ordem de detecção automática — o SearXNG requer uma baseUrl configurada (ordem 200 entre os provedores que já possuem a credencial necessária). Provedores sem necessidade de chave, como DuckDuckGo ou Ollama Web Search, nunca são selecionados implicitamente pela detecção automática; eles só são ativados quando provider é escolhido explicitamente
  • Auto-hospedado — você controla a instância, as consultas e os mecanismos de pesquisa upstream
  • Categorias usam general como padrão quando não estão configuradas
  • Fallback de categoria — se uma solicitação de categoria diferente de general for bem-sucedida, mas não retornar resultados, o OpenClaw repetirá a mesma consulta uma vez com general antes de retornar um conjunto de resultados vazio
  • Cache de resultados — consultas idênticas (mesma consulta, quantidade, categorias, idioma e URL base) são armazenadas em cache no processo por um TTL curto
  • Requisito de versão — o plugin declara minHostVersion: >=2026.6.9
Para que a API JSON do SearXNG funcione, verifique se a sua instância do SearXNG tem o formato json habilitado no arquivo settings.yml, em search.formats.

​
Relacionados