Zurück zur privaten Agentensuche

Suche nach Privatagenten / Leitfaden 6 von 6

Fehler und Fallbacks behandeln

Halten Sie Fehler sichtbar und definieren Sie, was der Agent als Nächstes tun soll.

SearXNG

Fügen Sie ein optionales Fallback-Signal hinzu

Sie können einen Wrapper hinzufügen, der zuerst SearXNG ausprobiert und dann auf Brave zurückgreift:

search-with-fallback.sh

#!/bin/bash
# Search with fallback: SearXNG → Brave

QUERY="$1"
LIMIT=${2:-5}

# Try SearXNG first
RESULT=$(~/.openclaw/skills/searxng/search.sh "$QUERY" "$LIMIT" 2>/dev/null)

if [ -n "$RESULT" ] && [ "$RESULT" != "No results or SearXNG unavailable" ]; then
  echo "# Results via SearXNG (private)"
  echo "$RESULT"
else
  echo "# SearXNG unavailable, falling back to Brave..."
  # Let OpenClaw's built-in web_search handle it
  echo "FALLBACK_TO_BRAVE: $QUERY"
fi

Verstehen Sie den Anforderungspfad

Der Agent ruft Ihr Skript auf, das den lokalen SearXNG-Dienst abfragt. SearXNG sendet die Abfrage an konfigurierte Engines und aggregiert deren Ergebnisse. Diese Engines empfangen die Anfrage und die IP Ihres Servers.

Der Fallback-Wrapper gibt die Markierung FALLBACK_TO_BRAVE aus. Er ruft Brave nicht selbst auf. Ihr Agent muss die Markierung erkennen und ein konfiguriertes Ersatzwerkzeug für die Suche aufrufen.

Wissen Sie, was Sie kontrollieren

  • Steuerung: Suchmaschinen, Protokollierung und Betriebseinstellungen selbst wählen.
  • Lokale Integration: Agenten verwenden einen gemeinsamen Endpunkt, den Sie betreiben.
  • Klare Grenzen: Die angebundenen Suchmaschinen erhalten weiterhin Suchanfragen. Sie können ausfallen oder die Anfragezahl begrenzen.

Fehlerbehebung

"Connection refused"

SearXNG läuft nicht. Prüfen Sie: docker ps | grep searxng

"format=json not supported"

Ergänzen Sie formats: [html, json] in settings.yml und starten Sie den Dienst neu.

Keine Ergebnisse für einige Abfragen

Manche Suchmaschinen begrenzen die Zahl der Anfragen. SearXNG wechselt automatisch zwischen ihnen. Versuchen Sie es erneut oder ergänzen Sie weitere Suchmaschinen in den Einstellungen.


Erweitern Sie das Setup

  • Weitere Suchmaschinen hinzufügen. Konfigurieren Sie DuckDuckGo, Qwant oder Mojeek in settings.yml.
  • Caching aktivieren. Reduzieren Sie wiederholte Abfragen mit Redis.
  • Auf VPS bereitstellen. Betreiben Sie SearXNG auf einem VPS, damit mehrere Agenten darauf zugreifen können.

Es funktioniert, wenn

Eine nicht verfügbare Suche erzeugt ein explizites Fehler- oder Fallback-Signal. Wenn Sie ein Backup-Tool konfigurieren, stellen Sie sicher, dass der Agent es tatsächlich aufruft, anstatt die Markierung als Ergebnis zu behandeln.