Recherche SearXNG

OpenClaw prend en charge SearXNG comme fournisseur web_search auto-hébergé, sans clé. SearXNG est un méta-moteur de recherche open source qui agrège les résultats de Google, Bing, DuckDuckGo et d'autres sources.

Avantages :

• Gratuit et illimité -- aucune clé API ni aucun abonnement commercial requis
• Confidentialité / isolation réseau -- les requêtes ne quittent jamais votre réseau
• Fonctionne partout -- aucune restriction régionale sur les API de recherche commerciales

# Configuration

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

openclaw configure --section web
# Select "searxng" as the provider

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

# Configuration

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

Paramètres au niveau Plugin pour l'instance SearXNG :

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

Le champ baseUrl accepte également les objets SecretRef.

Règles de transport :

• https:// fonctionne pour les hôtes SearXNG publics ou privés
• http:// n'est accepté que pour les hôtes de réseau privé de confiance ou de local loopback
• les hôtes SearXNG publics doivent utiliser https://
• les hôtes privés/internes utilisent la protection réseau auto-hébergée ; les hôtes publics https:// restent sur la protection stricte de recherche web et ne peuvent pas rediriger vers des adresses privées

# Variable d'environnement

Définissez SEARXNG_BASE_URL comme alternative à la configuration :

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

Lorsque SEARXNG_BASE_URL est définie et qu'aucun fournisseur explicite n'est configuré, la détection automatique sélectionne SearXNG automatiquement (avec la priorité la plus basse -- tout fournisseur adossé à une API avec une clé l'emporte d'abord).

# Référence de configuration du Plugin

# Notes

• API JSON -- utilise le point de terminaison natif format=json de SearXNG, pas le scraping HTML
• URL de résultats d'images -- les résultats de catégorie image incluent img_src lorsque SearXNG renvoie une URL d'image directe
• Aucune clé API -- fonctionne immédiatement avec toute instance SearXNG
• Validation de l'URL de base -- baseUrl doit être une URL http:// ou https:// valide ; les hôtes publics doivent utiliser https://
• Protection réseau -- les points de terminaison SearXNG privés/internes optent pour l'accès au réseau privé ; les points de terminaison SearXNG publics https:// conservent une protection SSRF stricte
• Ordre de détection automatique -- SearXNG est vérifié en dernier (ordre 200) dans la détection automatique. Les fournisseurs adossés à une API avec des clés configurées s'exécutent d'abord, puis DuckDuckGo (ordre 100), puis Ollama Web Search (ordre 110)
• Auto-hébergé -- vous contrôlez l'instance, les requêtes et les moteurs de recherche en amont
• Catégories vaut general par défaut lorsqu'elle n'est pas configurée
• Repli de catégorie -- si une requête de catégorie autre que general réussit mais renvoie zéro résultat, OpenClaw réessaie la même requête une fois avec general avant de renvoyer un ensemble de résultats vide

# Connexe

• Vue d'ensemble de Web Search -- tous les fournisseurs et la détection automatique
• Recherche DuckDuckGo -- autre solution de repli sans clé
• Brave Search -- résultats structurés avec niveau gratuit