Tools

Wyszukiwanie równoległe

Plugin Parallel udostępnia dwóch dostawców web_search usługi Parallel, którzy zwracają uszeregowane fragmenty zoptymalizowane pod kątem LLM z indeksu internetowego utworzonego dla agentów AI:

Dostawca	id	Uwierzytelnianie
Parallel Search (bezpłatny)	`parallel-free`	Brak — bezpłatny Search MCP usługi Parallel
Parallel Search	`parallel`	`PARALLEL_API_KEY` — płatny interfejs Search API, wyższe limity zapytań i dostrajanie celu

Ustaw tools.web.search.provider na parallel-free lub parallel, aby jawnie wybrać jednego z nich; żaden nie jest wykrywany automatycznie.

Instalowanie pluginu

bash

openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

Klucz API (płatny dostawca)

parallel-free nie wymaga klucza, ale nadal musi zostać wybrany jawnie. Płatny dostawca parallel wymaga klucza API:

Utwórz konto

Zarejestruj się w serwisie platform.parallel.ai i wygeneruj klucz API w swoim panelu.

Zapisz klucz

Ustaw PARALLEL_API_KEY w środowisku Gateway lub skonfiguruj go za pomocą:

bash

openclaw configure --section web

Konfiguracja

json5

{  plugins: {    entries: {      parallel: {        config: {          webSearch: {            apiKey: "par-...", // opcjonalne, jeśli ustawiono PARALLEL_API_KEY            baseUrl: "https://api.parallel.ai", // opcjonalne; OpenClaw dołącza /v1/search          },        },      },    },  },  tools: {    web: {      search: {        // "parallel-free" dla bezpłatnego Search MCP lub "parallel" dla        // pokazanego tutaj płatnego dostawcy korzystającego z API.        provider: "parallel",      },    },  },}

Alternatywa środowiskowa: ustaw PARALLEL_API_KEY w środowisku Gateway. W przypadku instalacji Gateway umieść go w ~/.openclaw/.env.

Nadpisywanie bazowego adresu URL

Dotyczy tylko płatnego dostawcy parallel; parallel-free zawsze używa adresu https://search.parallel.ai/mcp i ignoruje to ustawienie.

Ustaw plugins.entries.parallel.config.webSearch.baseUrl, aby kierować płatne żądania przez zgodny serwer proxy lub alternatywny punkt końcowy (na przykład Cloudflare AI Gateway). OpenClaw normalizuje same nazwy hostów, dodając przed nimi https://, oraz dołącza /v1/search, chyba że ścieżka już się nim kończy. Ustalony punkt końcowy jest częścią klucza pamięci podręcznej wyszukiwania, dlatego wyniki z różnych punktów końcowych nigdy nie są współdzielone.

Parametry narzędzia

Obaj dostawcy udostępniają natywny format wyszukiwania Parallel, dzięki czemu model podaje cel w języku naturalnym oraz kilka krótkich zapytań opartych na słowach kluczowych — jest to połączenie zalecane przez Parallel w celu uzyskania najlepszych wyników.

objectivestringrequired

Opis podstawowego pytania lub celu w języku naturalnym (maks. 5000 znaków). Powinien być samodzielnie zrozumiały.

search_queriesstring[]required

Zwięzłe zapytania wyszukiwania oparte na słowach kluczowych, każde po 3–6 słów (1–5 pozycji, maks. 200 znaków każda). Aby uzyskać najlepsze wyniki, podaj 2–3 zróżnicowane zapytania.

countnumber

Liczba zwracanych wyników (1–40).

session_idstring

Opcjonalny identyfikator sesji Parallel z pola sessionId poprzedniego wyniku. Przekazuj go w kolejnych wyszukiwaniach w ramach tego samego zadania, aby Parallel grupował powiązane wywołania i ulepszał następne wyniki. Maksymalnie 1000 znaków w parallel; bezpłatny Search MCP parallel-free ogranicza go do 100. Identyfikator przekraczający limit jest odrzucany (wersja płatna) lub zastępowany nowym (wersja bezpłatna).

client_modelstring

Opcjonalny identyfikator modelu wykonującego wywołanie (np. claude-opus-4-7, gpt-5.6-sol), maks. 100 znaków. Umożliwia Parallel dostosowanie ustawień domyślnych do możliwości modelu. Przekaż dokładny identyfikator aktywnego modelu; nie skracaj go do aliasu rodziny.

Uwagi

Parallel szereguje i kompresuje wyniki pod kątem przydatności w rozumowaniu LLM, a nie przechodzenia użytkowników do stron; należy oczekiwać treściwych fragmentów dla każdego wyniku zamiast zawartości całych stron.
Fragmenty wyników są zwracane jako tablica excerpts, a także łączone w polu description w celu zapewnienia zgodności z ogólnym kontraktem web_search.
Obaj dostawcy zwracają session_id; OpenClaw udostępnia go jako sessionId w danych narzędzia, aby wywołujący mogli grupować kolejne wyszukiwania. Identyfikator sesji wygenerowany przez Parallel (czyli taki, którego nie podał wywołujący) jest wykluczany z wpisu pamięci podręcznej, ponieważ niepowiązane zadania z identycznymi zapytaniami nie powinny go dziedziczyć.
Pola searchId, warnings i usage z Parallel są przekazywane, gdy są dostępne.
OpenClaw zawsze przekazuje ustaloną liczbę wyników do Parallel jako advanced_settings.max_results (parallel) lub stosuje count po stronie klienta po otrzymaniu odpowiedzi Parallel o stałym rozmiarze (parallel-free). Argument count wywołującego ma pierwszeństwo, następnie tools.web.search.maxResults, a w pozostałych przypadkach używana jest ogólna wartość domyślna web_search w OpenClaw (5) — domyślna wartość własnego API Parallel wynosi 10.
Wyniki są domyślnie przechowywane w pamięci podręcznej przez 15 minut (cacheTtlMinutes).
parallel-free tworzy nowy session_id dla każdego wywołania za pośrednictwem uzgadniania MCP, gdy wywołujący go nie poda; parallel pozostawia go w takim przypadku nieustawionym.

Powiązane

Omówienie wyszukiwania internetowego — wszyscy dostawcy i automatyczne wykrywanie
Wyszukiwanie Exa — wyszukiwanie neuronowe z wyodrębnianiem treści
Perplexity Search — ustrukturyzowane wyniki z filtrowaniem domen

Was this useful?