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, чтобы явно выбрать один из них; автоматическое обнаружение не выполняется ни для одного из них.

Установка плагина

bash
openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

Ключ API (платный провайдер)

Для parallel-free ключ не нужен, но этот провайдер всё равно необходимо выбрать явно. Для платного провайдера parallel требуется ключ API:

  • Создание учётной записи

    Зарегистрируйтесь на platform.parallel.ai и создайте ключ API на панели управления.

  • Сохранение ключа

    Задайте PARALLEL_API_KEY в окружении Gateway или выполните настройку с помощью:

    bash
    openclaw configure --section web
  • Конфигурация

    json5
    {  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_search OpenClaw по умолчанию (5); собственное значение API Parallel по умолчанию равно 10.
    • По умолчанию результаты кешируются на 15 минут (cacheTtlMinutes).
    • parallel-free создаёт новый session_id для каждого вызова посредством согласования MCP, если вызывающая сторона его не предоставляет; parallel в таком случае оставляет его незаданным.

    Связанные материалы

    • Обзор веб-поиска — все провайдеры и автоматическое обнаружение
    • Поиск Exa — нейронный поиск с извлечением содержимого
    • Поиск Perplexity — структурированные результаты с фильтрацией по доменам
    Was this useful?
    On this page

    On this page