Skip to main content
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

1

Installer le plugin

2

Exécuter une instance SearXNG

Vous pouvez également utiliser tout déploiement SearXNG existant auquel vous avez accès. Consultez la documentation de SearXNG pour la configuration en production.
3

Configurer

Vous pouvez également définir la variable d’environnement et laisser la détection automatique la trouver :

​
Configuration

Paramètres du plugin pour l’instance SearXNG :
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 :
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
Pour que l’API JSON de SearXNG fonctionne, assurez-vous que le format json est activé dans le fichier settings.yml de votre instance SearXNG, sous search.formats.

​
Voir aussi