Skip to main content
Das Parallel-Plugin stellt zwei Parallel web_search Provider bereit, die beide nach Relevanz geordnete, für LLMs optimierte Auszüge aus einem für KI-Agenten erstellten Webindex zurückgeben: Setzen Sie tools.web.search.provider auf parallel-free oder parallel, um einen Provider explizit auszuwählen; keiner wird automatisch erkannt.
Direkte OpenAI-Responses-Modelle (api: "openai-responses", Provider openai, offizielle API-Basis-URL) verwenden automatisch die von OpenAI gehostete native Websuche, wenn tools.web.search.provider nicht gesetzt, leer, "auto" oder "openai" ist — daher umgehen sie Parallel standardmäßig. Setzen Sie tools.web.search.provider auf parallel-free oder parallel, um sie stattdessen über Parallel zu leiten. Siehe Übersicht zur Websuche.

​
Plugin installieren

​
API-Schlüssel (kostenpflichtiger Provider)

parallel-free benötigt keinen Schlüssel, muss aber dennoch explizit ausgewählt werden. Der kostenpflichtige Provider parallel benötigt einen API-Schlüssel:
1

Konto erstellen

Registrieren Sie sich unter platform.parallel.ai und generieren Sie in Ihrem Dashboard einen API-Schlüssel.
2

Schlüssel speichern

Setzen Sie PARALLEL_API_KEY in der Gateway-Umgebung oder konfigurieren Sie ihn über:

​
Konfiguration

Alternative über die Umgebung: Setzen Sie PARALLEL_API_KEY in der Gateway-Umgebung. Bei einer Gateway-Installation tragen Sie es in ~/.openclaw/.env ein.

​
Überschreiben der Basis-URL

Gilt nur für den kostenpflichtigen Provider parallel; parallel-free verwendet immer https://search.parallel.ai/mcp und ignoriert diese Einstellung. Setzen Sie plugins.entries.parallel.config.webSearch.baseUrl, um kostenpflichtige Anfragen über einen kompatiblen Proxy oder alternativen Endpunkt zu leiten (zum Beispiel das Cloudflare AI Gateway). OpenClaw normalisiert reine Hostnamen, indem https:// vorangestellt wird, und hängt /v1/search an, sofern der Pfad nicht bereits damit endet. Der aufgelöste Endpunkt ist Teil des Such-Cache-Schlüssels, sodass Ergebnisse verschiedener Endpunkte niemals gemeinsam verwendet werden.

​
Tool-Parameter

Beide Provider stellen Parallels natives Suchformat bereit, sodass das Modell ein natürlichsprachliches Ziel und einige kurze Schlüsselwortanfragen ausfüllt — die Kombination, die Parallel für optimale Ergebnisse empfiehlt.
​
string
erforderlich
Natürlichsprachliche Beschreibung der zugrunde liegenden Frage oder des Ziels (maximal 5000 Zeichen). Sollte eigenständig verständlich sein.
​
string[]
erforderlich
Prägnante Schlüsselwort-Suchanfragen mit jeweils 3-6 Wörtern (1-5 Einträge, jeweils maximal 200 Zeichen). Geben Sie für optimale Ergebnisse 2-3 unterschiedliche Anfragen an.
​
number
Anzahl der zurückzugebenden Ergebnisse (1-40).
​
string
Optionale Parallel-Sitzungs-ID aus sessionId eines vorherigen Ergebnisses. Übergeben Sie sie bei Folgesuchen innerhalb derselben Aufgabe, damit Parallel zusammengehörige Aufrufe gruppiert und nachfolgende Ergebnisse verbessert. Maximal 1000 Zeichen bei parallel; der kostenlose parallel-free Search MCP begrenzt sie auf 100. Eine ID oberhalb des Grenzwerts wird verworfen (kostenpflichtig) oder neu erzeugt (kostenlos).
​
string
Optionale Kennung des Modells, das den Aufruf ausführt (z. B. claude-opus-4-7, gpt-5.6-sol), maximal 100 Zeichen. Ermöglicht Parallel, die Standardeinstellungen an die Fähigkeiten Ihres Modells anzupassen. Übergeben Sie den exakten Slug des aktiven Modells; kürzen Sie ihn nicht auf einen Familienalias.

​
Hinweise

  • Parallel ordnet und komprimiert Ergebnisse nach ihrem Nutzen für LLM-Schlussfolgerungen, nicht für menschliche Klicks; erwarten Sie daher kompakte Auszüge pro Ergebnis statt vollständiger Seiteninhalte.
  • Ergebnisauszüge werden als Array excerpts zurückgegeben und außerdem für die Kompatibilität mit dem generischen Vertrag web_search in description zusammengeführt.
  • Beide Provider geben eine session_id zurück; OpenClaw stellt sie als sessionId in der Tool-Nutzlast bereit, damit Aufrufer Folgesuchen gruppieren können. Eine von Parallel generierte Sitzungs-ID (die nicht vom Aufrufer bereitgestellt wurde) wird aus dem Cache-Eintrag ausgeschlossen, da nicht zusammengehörige Aufgaben mit identischen Anfragen sie nicht übernehmen sollten.
  • searchId, warnings und usage von Parallel werden weitergegeben, wenn sie vorhanden sind.
  • OpenClaw übermittelt immer eine aufgelöste Ergebnisanzahl als advanced_settings.max_results (parallel) an Parallel oder wendet count clientseitig nach Parallels Antwort mit fester Größe an (parallel-free). Das Argument count des Aufrufers hat Vorrang, danach tools.web.search.maxResults, andernfalls gilt OpenClaws generischer Standardwert web_search (5) — Parallels eigener API-Standardwert ist 10.
  • Ergebnisse werden standardmäßig 15 Minuten zwischengespeichert (cacheTtlMinutes).
  • parallel-free erzeugt über seinen MCP-Handshake bei jedem Aufruf eine neue session_id, wenn der Aufrufer keine bereitstellt; parallel lässt sie in diesem Fall nicht gesetzt.

​
Verwandte Themen