Recherche SearXNG

OpenClaw prend en charge SearXNG en tant que 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é 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 imposée par les API de recherche commerciales

Configuration

openclaw plugins install @openclaw/searxng-plugin

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

openclaw configure --section web# Sélectionnez "searxng" comme fournisseur

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

Configuration

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

Paramètres du plugin pour l’instance SearXNG :

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

baseUrl accepte également un objet SecretRef (par exemple { source: "env", id: "SEARXNG_BASE_URL" }).

Variable d’environnement

Définissez SEARXNG_BASE_URL comme alternative à la configuration :

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

Ordre de résolution : la chaîne baseUrl configurée, puis une SecretRef d’environnement intégrée dans baseUrl, puis SEARXNG_BASE_URL. Lorsqu’aucun chemin de configuration n’est défini et que SEARXNG_BASE_URL est présent sans qu’un fournisseur ait été explicitement choisi, la détection automatique sélectionne SearXNG.

Référence de configuration du plugin

L’appel de l’outil web_search accepte également count (1 à 10 résultats), categories et language comme valeurs de remplacement propres à chaque appel.

Remarques

• API JSON -- utilise le point de terminaison natif format=json de SearXNG, et non l’extraction de contenu HTML
• URL des résultats d’images -- les résultats de la catégorie des images incluent img_src lorsque SearXNG renvoie une URL d’image directe
• Aucune clé API -- fonctionne immédiatement avec n’importe quelle instance SearXNG
• Validation de l’URL de base -- baseUrl doit être une URL http:// ou https:// valide
• Protection réseau -- les URL de base http:// doivent cibler un hôte privé ou local loopback de confiance (les hôtes publics doivent utiliser https://) ; les URL de base https:// qui se résolvent vers une adresse privée/interne bénéficient de la même autorisation d’auto-hébergement, tandis que celles qui se résolvent publiquement conservent une protection SSRF stricte
• Ordre de détection automatique -- SearXNG nécessite une baseUrl configurée (priorité 200 parmi les fournisseurs disposant déjà de leurs identifiants requis). Les fournisseurs sans clé, tels que DuckDuckGo ou Ollama Web Search, ne sont jamais sélectionnés implicitement par la détection automatique ; ils ne s’activent que lorsque provider est explicitement choisi
• Auto-hébergé -- vous contrôlez l’instance, les requêtes et les moteurs de recherche en amont
• Catégories -- la valeur par défaut est general lorsqu’elles ne sont pas configurées
• Repli de catégorie -- si une requête pour une catégorie autre que general réussit mais ne renvoie aucun résultat, OpenClaw réessaie une fois la même requête avec general avant de renvoyer un ensemble de résultats vide
• Mise en cache des résultats -- les requêtes identiques (même requête, nombre, catégories, langue et URL de base) sont mises en cache dans le processus pendant une courte durée de vie
• Version requise -- le plugin déclare minHostVersion: >=2026.6.9

Voir aussi

• Présentation de la recherche web -- tous les fournisseurs et la détection automatique
• Recherche DuckDuckGo -- un autre fournisseur sans clé
• Brave Search -- résultats structurés avec une offre gratuite