Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw oferece suporte ao SearXNG como um provedor web_search auto-hospedado e sem chave. SearXNG é um mecanismo de metabusca de código aberto que agrega resultados do Google, Bing, DuckDuckGo e 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 em APIs de busca comerciais

​
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 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á-la:
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:// só é aceito para hosts confiáveis em rede privada ou loopback
  • hosts SearXNG públicos devem usar https://
  • hosts privados/internos usam a proteção de rede auto-hospedada; hosts públicos https:// permanecem na proteção rigorosa de busca na web e não podem redirecionar para endereços privados

​
Variável de ambiente

Defina SEARXNG_BASE_URL como alternativa à configuração: 
export SEARXNG_BASE_URL="http://localhost:8888"
Quando SEARXNG_BASE_URL está definida e nenhum provedor explícito está configurado, a detecção automática seleciona o SearXNG automaticamente (na prioridade mais baixa — qualquer provedor baseado em API com uma chave 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
  • URLs de resultados de imagem — resultados da categoria de imagens incluem img_src quando o SearXNG retorna uma URL direta de 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; hosts públicos devem usar https://
  • Proteção de rede — endpoints SearXNG privados/internos aderem ao acesso de rede privada; endpoints SearXNG públicos https:// mantêm proteção SSRF rigorosa
  • Ordem de detecção automática — SearXNG é verificado por último (ordem 200) na detecção automática. Provedores baseados em API com chaves configuradas são executados primeiro, depois DuckDuckGo (ordem 100), depois Ollama Web Search (ordem 110)
  • Auto-hospedado — você controla a instância, as consultas e os mecanismos de busca upstream
  • Categorias usam general por padrão quando não configuradas
  • Fallback de categoria — se uma solicitação de categoria não general tiver sucesso, mas retornar zero resultados, OpenClaw tenta novamente a mesma consulta uma vez com general antes de retornar um conjunto de resultados vazio
Para que a API JSON do SearXNG funcione, certifique-se de que sua instância do SearXNG tenha o formato json habilitado em seu settings.yml em search.formats.

​
Relacionados