Recherche SearXNG

OpenClaw prend en charge SearXNG en tant que provider 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 ou abonnement commercial requis
Confidentialité / air-gap — les requêtes ne quittent jamais votre réseau
Fonctionne partout — aucune restriction régionale sur les APIs de recherche commerciaux

Configuration

Exécuter une instance SearXNG
Fenêtre de terminal
```
docker run -d -p 8888:8080 searxng/searxng
```
Ou utilisez tout déploiement SearXNG existant auquel vous avez accès. Consultez la documentation SearXNG pour la configuration de production.
Configurer
Fenêtre de terminal
```
openclaw configure --section web
# Select "searxng" as the provider
```
Ou définissez la env var et laissez la détection automatique la trouver :
Fenêtre de terminal
```
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.

Variable d’environnement

Définissez SEARXNG_BASE_URL comme alternative à la config :

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

Lorsque SEARXNG_BASE_URL est défini et qu’aucun provider explicite n’est configuré, la détection automatique choisit SearXNG automatiquement (à la priorité la plus basse — tout provider API avec une clé l’emporte en premier).

Référence de configuration du plugin

Champ	Description
`baseUrl`	URL de base de votre instance SearXNG (requis)
`categories`	Catégories séparées par des virgules telles que `general`, `news`, ou `science`
`language`	Code de langue pour les résultats tel que `en`, `de`, ou `fr`

Notes

API JSON — utilise le point de terminaison natif format=json de SearXNG, pas le scraping HTML
Pas de clé API — fonctionne avec n’importe quelle instance SearXNG immédiatement
Ordre de détection automatique — SearXNG est vérifié en dernier (ordre 200) lors de la détection automatique, donc tout provider soutenu par une API avec une clé est prioritaire sur SearXNG, et SearXNG se situe derrière DuckDuckGo (ordre 100) également
Auto-hébergé — vous contrôlez l’instance, les requêtes et les moteurs de recherche en amont
Catégories par défaut general lorsqu’elles ne sont pas configurées

Connexes

Aperçu de la recherche Web — tous les providers et la détection automatique
Recherche DuckDuckGo — autre alternative sans clé
Recherche Brave — résultats structurés avec une version gratuite