Recherche SearXNG

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

Avantages :

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

Configuration

openclaw plugins install @openclaw/searxng-plugin

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

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

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

Config

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

Paramètres au niveau du 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é ou de bouclage de confiance
• les hôtes SearXNG publics doivent utiliser https://
• les hôtes privés/internes utilisent la garde réseau auto-hébergée ; les hôtes publics en https:// restent sur la garde 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éfini et qu’aucun fournisseur explicite n’est configuré, l’auto-détection sélectionne automatiquement SearXNG (à 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 de scraping HTML
• URL des résultats d’image -- les résultats de catégorie image incluent img_src lorsque SearXNG renvoie une URL d’image directe
• Aucune clé d’API -- fonctionne directement avec n’importe quelle instance SearXNG
• Validation de l’URL de base -- baseUrl doit être une URL http:// ou https:// valide ; les hôtes publics doivent utiliser https://
• Garde 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 en https:// conservent une protection SSRF stricte
• Ordre d’auto-détection -- SearXNG est vérifié après les fournisseurs adossés à une API avec des clés configurées (ordre 200). Les fournisseurs sans clé comme DuckDuckGo ou Ollama Web Search ne sont pas sélectionnés automatiquement sans choix explicite du fournisseur
• Auto-hébergé -- vous contrôlez l’instance, les requêtes et les moteurs de recherche en amont
• Catégories utilise general par défaut lorsqu’elles ne sont pas configurées
• Repli de catégorie -- si une requête de catégorie non general réussit mais renvoie zéro résultat, OpenClaw réessaie une fois la même requête avec general avant de renvoyer un ensemble de résultats vide

Connexe

• Vue d’ensemble de la recherche Web -- tous les fournisseurs et l’auto-détection
• Recherche DuckDuckGo -- un autre fournisseur sans clé
• Brave Search -- résultats structurés avec offre gratuite