Passer au contenu principal
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

1

Installer le plugin

openclaw plugins install @openclaw/searxng-plugin
2

Exécuter une instance SearXNG

docker run -d -p 8888:8080 searxng/searxng
Ou utilisez n’importe quel déploiement SearXNG existant auquel vous avez accès. Consultez la documentation SearXNG pour la configuration en production.
3

Configurer

openclaw configure --section web
# Select "searxng" as the provider
Ou définissez la variable d’environnement et laissez l’auto-détection la trouver :
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

ChampDescription
baseUrlURL de base de votre instance SearXNG (obligatoire)
categoriesCatégories séparées par des virgules, comme general, news ou science
languageCode de langue des résultats, comme en, de ou fr

​
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
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.

​
Connexe