Pesquisa do SearXNG

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

openclaw plugins install @openclaw/searxng-plugin

docker run -d -p 8888:8080 searxng/searxng

openclaw configure --section web# Selecione "searxng" como provedor

export SEARXNG_BASE_URL="http://localhost:8888"

Configuração

{  tools: {    web: {      search: {        provider: "searxng",      },    },  },}

Configurações no nível do plugin para a instância do SearXNG:

{  plugins: {    entries: {      searxng: {        config: {          webSearch: {            baseUrl: "http://localhost:8888",            categories: "general,news", // opcional            language: "en", // opcional          },        },      },    },  },}

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:

export SEARXNG_BASE_URL="http://localhost:8888"

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

Relacionados

• Visão geral da pesquisa na web -- todos os provedores e a detecção automática
• Pesquisa do DuckDuckGo -- outro provedor sem necessidade de chave
• Pesquisa do Brave -- resultados estruturados com plano gratuito