Tools
Параллельный поиск
Плагин Parallel предоставляет два провайдера Parallel web_search,
оба из которых возвращают ранжированные, оптимизированные для LLM фрагменты
из веб-индекса, созданного для ИИ-агентов:
| Провайдер | id | Аутентификация |
|---|---|---|
| Parallel Search (бесплатный) | parallel-free |
Не требуется — бесплатный Search MCP от Parallel |
| Parallel Search | parallel |
PARALLEL_API_KEY — платный Search API, более высокие лимиты запросов и настройка цели |
Установите tools.web.search.provider в значение parallel-free или parallel, чтобы явно
выбрать один из них; автоматическое обнаружение не выполняется ни для одного из них.
Установка плагина
openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restartКлюч API (платный провайдер)
Для parallel-free ключ не нужен, но этот провайдер всё равно необходимо выбрать явно. Для платного
провайдера parallel требуется ключ API:
Создание учётной записи
Зарегистрируйтесь на platform.parallel.ai и создайте ключ API на панели управления.
Сохранение ключа
Задайте PARALLEL_API_KEY в окружении Gateway или выполните настройку с помощью:
openclaw configure --section webКонфигурация
{ plugins: { entries: { parallel: { config: { webSearch: { apiKey: "par-...", // необязательно, если задан PARALLEL_API_KEY baseUrl: "https://api.parallel.ai", // необязательно; OpenClaw добавляет /v1/search }, }, }, }, }, tools: { web: { search: { // "parallel-free" для бесплатного Search MCP или "parallel" для // показанного здесь платного провайдера на основе API. provider: "parallel", }, }, },}Альтернатива через переменную окружения: задайте PARALLEL_API_KEY в окружении
Gateway. При установке Gateway поместите её в ~/.openclaw/.env.
Переопределение базового URL
Применяется только к платному провайдеру parallel; parallel-free всегда использует
https://search.parallel.ai/mcp и игнорирует эту настройку.
Задайте plugins.entries.parallel.config.webSearch.baseUrl, чтобы направлять платные
запросы через совместимый прокси-сервер или альтернативную конечную точку (например,
Cloudflare AI Gateway). OpenClaw нормализует адреса, содержащие только имя хоста, добавляя в начало
https://, и добавляет /v1/search, если путь ещё не оканчивается на него. Итоговая
конечная точка входит в ключ кеша поиска, поэтому результаты из разных
конечных точек никогда не используются совместно.
Параметры инструмента
Оба провайдера предоставляют нативную структуру поиска Parallel, чтобы модель заполняла цель на естественном языке и несколько коротких запросов по ключевым словам — сочетание, которое Parallel рекомендует для получения наилучших результатов.
objectivestringrequiredОписание исходного вопроса или цели на естественном языке (не более 5000 символов). Должно быть самодостаточным.
search_queriesstring[]requiredКраткие поисковые запросы по ключевым словам, по 3–6 слов каждый (1–5 элементов, не более 200 символов каждый). Для наилучших результатов укажите 2–3 разнообразных запроса.
countnumberКоличество возвращаемых результатов (1–40).
session_idstringНеобязательный идентификатор сеанса Parallel из поля sessionId предыдущего результата. Передавайте его
при последующих поисках в рамках той же задачи, чтобы Parallel группировал связанные вызовы и
улучшал последующие результаты. Не более 1000 символов для parallel; бесплатный
Search MCP parallel-free ограничивает его длину до 100. Идентификатор, превышающий ограничение,
отбрасывается (для платного провайдера) или заменяется новым (для бесплатного).
client_modelstringНеобязательный идентификатор модели, выполняющей вызов (например, claude-opus-4-7,
gpt-5.6-sol), не более 100 символов. Позволяет Parallel адаптировать настройки по умолчанию к
возможностям вашей модели. Передавайте точный слаг активной модели; не сокращайте его до
псевдонима семейства.
Примечания
- Parallel ранжирует и сжимает результаты для удобства рассуждений LLM, а не для переходов пользователей по ссылкам; вместо полного содержимого страниц ожидайте насыщенные фрагменты для каждого результата.
- Фрагменты результатов возвращаются в массиве
excerpts, а также объединяются вdescriptionдля совместимости с универсальным контрактомweb_search. - Оба провайдера возвращают
session_id; OpenClaw предоставляет его какsessionIdв полезной нагрузке инструмента, чтобы вызывающая сторона могла группировать последующие поиски. Идентификатор сеанса, созданный Parallel (то есть не переданный вызывающей стороной), исключается из записи кеша, поскольку несвязанные задачи с одинаковыми запросами не должны наследовать его. searchId,warningsиusageот Parallel передаются без изменений при наличии.- OpenClaw всегда передаёт Parallel определённое количество результатов как
advanced_settings.max_results(parallel) или применяетcountна стороне клиента после ответа Parallel фиксированного размера (parallel-free). Аргументcountвызывающей стороны имеет наивысший приоритет, затем используетсяtools.web.search.maxResults, а иначе — универсальное значениеweb_searchOpenClaw по умолчанию (5); собственное значение API Parallel по умолчанию равно 10. - По умолчанию результаты кешируются на 15 минут (
cacheTtlMinutes). parallel-freeсоздаёт новыйsession_idдля каждого вызова посредством согласования MCP, если вызывающая сторона его не предоставляет;parallelв таком случае оставляет его незаданным.
Связанные материалы
- Обзор веб-поиска — все провайдеры и автоматическое обнаружение
- Поиск Exa — нейронный поиск с извлечением содержимого
- Поиск Perplexity — структурированные результаты с фильтрацией по доменам