Pular para o conteúdo principal

​
Pesquisa SearXNG

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

​
Configuração

1

Execute uma instância do SearXNG

docker run -d -p 8888:8080 searxng/searxng
Ou use qualquer implantação existente do SearXNG à qual você tenha acesso. Consulte a documentação do SearXNG para a configuração de produção.
2

Configure

openclaw configure --section web
# Select "searxng" as the provider
Ou defina a variável de ambiente e deixe a detecção automática encontrá-lo:
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", // optional
            language: "en", // optional
          },
        },
      },
    },
  },
}
O campo baseUrl também aceita objetos SecretRef. Regras de transporte:
  • https:// funciona para hosts SearXNG públicos ou privados
  • http:// é aceito apenas para hosts confiáveis em rede privada ou loopback
  • hosts SearXNG públicos devem usar https://

​
Variável de ambiente

Defina SEARXNG_BASE_URL como alternativa à configuração: 
export SEARXNG_BASE_URL="http://localhost:8888"
Quando SEARXNG_BASE_URL é definida e nenhum provedor explícito está configurado, a detecção automática seleciona o SearXNG automaticamente (na prioridade mais baixa — qualquer provedor com suporte a API e com chave configurada vence primeiro).

​
Referência de configuração do plugin

CampoDescrição
baseUrlURL base da sua instância do SearXNG (obrigatório)
categoriesCategorias separadas por vírgula, como general, news ou science
languageCódigo de idioma para resultados, como en, de ou fr

​
Observações

  • API JSON — usa o endpoint nativo format=json do SearXNG, não raspagem de HTML
  • Sem chave de API — funciona com qualquer instância do SearXNG pronta para uso
  • Validação da URL base — baseUrl deve ser uma URL http:// ou https:// válida; hosts públicos devem usar https://
  • Ordem de detecção automática — o SearXNG é verificado por último (ordem 200) na detecção automática. Provedores com suporte a API e com chaves configuradas são executados primeiro, depois o DuckDuckGo (ordem 100) e depois o Ollama Web Search (ordem 110)
  • Auto-hospedado — você controla a instância, as consultas e os mecanismos de pesquisa upstream
  • Categories usa general por padrão quando não está configurado
Para a API JSON do SearXNG funcionar, verifique se a sua instância do SearXNG tem o formato json habilitado em settings.yml, em search.formats.

​
Relacionado