Tools

Parallele Suche

Das Parallel-Plugin stellt zwei web_search-Provider von Parallel bereit. Beide liefern bewertete, für LLMs optimierte Auszüge aus einem für KI-Agenten erstellten Webindex:

Provider	id	Authentifizierung
Parallel-Suche (kostenlos)	`parallel-free`	Keine – Parallels kostenloser Search MCP
Parallel-Suche	`parallel`	`PARALLEL_API_KEY` – kostenpflichtige Search API, höhere Ratenlimits und Zieloptimierung

Setzen Sie tools.web.search.provider auf parallel-free oder parallel, um einen Provider explizit auszuwählen; keiner von beiden wird automatisch erkannt.

Plugin installieren

bash

openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

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:

Konto erstellen

Registrieren Sie sich unter platform.parallel.ai und erzeugen Sie über Ihr Dashboard einen API-Schlüssel.

Schlüssel speichern

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

bash

openclaw configure --section web

Konfiguration

json5

{  plugins: {    entries: {      parallel: {        config: {          webSearch: {            apiKey: "par-...", // optional, wenn PARALLEL_API_KEY gesetzt ist            baseUrl: "https://api.parallel.ai", // optional; OpenClaw hängt /v1/search an          },        },      },    },  },  tools: {    web: {      search: {        // "parallel-free" für den kostenlosen Search MCP oder "parallel" für den        // hier dargestellten kostenpflichtigen, API-gestützten Provider.        provider: "parallel",      },    },  },}

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

Basis-URL überschreiben

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 einen alternativen Endpunkt zu leiten (beispielsweise das Cloudflare AI Gateway). OpenClaw normalisiert reine Hostnamen, indem es https:// voranstellt, 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 das native Suchschema von Parallel bereit, damit das Modell ein natürlichsprachiges Ziel sowie einige kurze Suchanfragen mit Schlüsselwörtern angibt – die Kombination, die Parallel für optimale Ergebnisse empfiehlt.

objectivestringrequired

Natürlichsprachige Beschreibung der zugrunde liegenden Frage oder des Ziels (maximal 5.000 Zeichen). Sollte in sich geschlossen sein.

search_queriesstring[]required

Prägnante Suchanfragen mit Schlüsselwörtern, jeweils 3–6 Wörter (1–5 Einträge, jeweils maximal 200 Zeichen). Geben Sie für optimale Ergebnisse 2–3 unterschiedliche Suchanfragen an.

countnumber

Anzahl der zurückzugebenden Ergebnisse (1–40).

session_idstring

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 1.000 Zeichen bei parallel; der kostenlose Search MCP parallel-free begrenzt sie auf 100. Eine ID, die den Grenzwert überschreitet, wird verworfen (kostenpflichtig) oder durch eine neu erzeugte ersetzt (kostenlos).

client_modelstring

Optionale Kennung des Modells, das den Aufruf ausführt (z. B. claude-opus-4-7, gpt-5.6-sol), maximal 100 Zeichen. Dadurch kann Parallel die Standardeinstellungen an die Fähigkeiten Ihres Modells anpassen. Übergeben Sie den exakten Slug des aktiven Modells; kürzen Sie ihn nicht auf einen Familienalias.

Hinweise

Parallel bewertet und komprimiert Ergebnisse im Hinblick auf ihren Nutzen für die Schlussfolgerungen von LLMs, nicht für menschliche Klicks; erwarten Sie daher dichte 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 web_search-Vertrag 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 erzeugte Sitzungs-ID, die nicht vom Aufrufer angegeben wurde, wird aus dem Cache-Eintrag ausgeschlossen, da voneinander unabhängige Aufgaben mit identischen Suchanfragen sie nicht übernehmen sollten.
searchId, warnings und usage von Parallel werden, sofern vorhanden, unverändert weitergegeben.
OpenClaw übermittelt Parallel stets eine aufgelöste Ergebnisanzahl als advanced_settings.max_results (parallel) oder wendet count nach der Antwort von Parallel mit fester Größe clientseitig an (parallel-free). Das Argument count des Aufrufers hat Vorrang, danach folgt tools.web.search.maxResults; andernfalls gilt der generische Standardwert von OpenClaw für web_search (5) – der eigene API-Standardwert von Parallel ist 10.
Ergebnisse werden standardmäßig 15 Minuten zwischengespeichert (cacheTtlMinutes).
parallel-free erzeugt über seinen MCP-Handshake für jeden Aufruf eine neue session_id, wenn der Aufrufer keine angibt; parallel lässt sie in diesem Fall nicht gesetzt.