OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Perplexity

Плагин Perplexity регистрирует провайдера web_search с двумя транспортами: нативным Perplexity Search API (структурированные результаты с фильтрами) и чат-завершениями Perplexity Sonar напрямую или через OpenRouter (ответы, синтезированные ИИ, с указанием источников).

Свойство Значение
Тип Провайдер веб-поиска (не провайдер моделей)
Аутентификация PERPLEXITY_API_KEY (нативный) или OPENROUTER_API_KEY (через OpenRouter)
Путь конфигурации plugins.entries.perplexity.config.webSearch.apiKey
Переопределения plugins.entries.perplexity.config.webSearch.baseUrl / .model
Получение ключа perplexity.ai/settings/api

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

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

Начало работы

  • Укажите ключ API

    bash
    openclaw configure --section web

    Или укажите ключ напрямую:

    bash
    openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"

    Также можно экспортировать ключ как PERPLEXITY_API_KEY или OPENROUTER_API_KEY в окружении Gateway.

  • Начните поиск

    web_search автоматически обнаруживает Perplexity, когда его ключ является доступными учётными данными для поиска; дополнительная настройка не требуется. Чтобы явно закрепить провайдера:

    bash
    openclaw config set tools.web.search.provider perplexity

    • Режимы поиска

    Плагин определяет транспорт в следующем порядке:

    1. webSearch.baseUrl или webSearch.model задан: запросы всегда направляются через чат-завершения Sonar к этой конечной точке независимо от типа ключа.
    2. В противном случае конечную точку определяет источник ключа: префикс настроенного ключа выбирает транспорт (конфигурация имеет приоритет над переменными окружения); ключ из окружения напрямую использует соответствующую ему конечную точку.
    Префикс ключа Транспорт Возможности
    pplx- Нативный Perplexity Search API (https://api.perplexity.ai) Структурированные результаты, фильтры по домену, языку и дате
    sk-or- OpenRouter (https://openrouter.ai/api/v1), модель Sonar Ответы, синтезированные ИИ, с указанием источников

    Настроенный ключ с любым другим префиксом также использует нативный Search API. Путь чат-завершений по умолчанию использует модель perplexity/sonar-pro; её можно переопределить с помощью plugins.entries.perplexity.config.webSearch.model.

    Фильтрация нативного API

    Фильтр Описание Транспорт
    count Результатов на один поиск: 1–10 (по умолчанию 5) Только нативный
    freshness Период актуальности: day, week, month, year Оба
    country Двухбуквенный код страны (us, de, jp) Только нативный
    language Код языка ISO 639-1 (en, fr, zh) Только нативный
    date_after / date_before Диапазон дат публикации в формате YYYY-MM-DD Только нативный
    domain_filter Не более 20 доменов; список разрешённых или список запрещённых с префиксом -, но не оба одновременно Только нативный
    max_tokens / max_tokens_per_page Лимит содержимого для всех результатов / одной страницы Только нативный

    Фильтры, доступные только для нативного транспорта, при использовании пути чат-завершений возвращают информативную ошибку. freshness нельзя сочетать с date_after/date_before.

    Расширенная конфигурация

    Переменная окружения для фоновых процессов
    Настройка прокси OpenRouter

    Чтобы направлять поисковые запросы Perplexity через OpenRouter, укажите OPENROUTER_API_KEY (префикс sk-or-) вместо нативного ключа Perplexity. OpenClaw обнаружит ключ и автоматически переключится на транспорт Sonar. Это удобно, если вы уже настроили оплату в OpenRouter и хотите объединить там провайдеров.

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

    Инструмент поиска Perplexity

    Как агент выполняет поиск через Perplexity и интерпретирует результаты.
    Справочник по конфигурации

    Полный справочник по конфигурации, включая записи плагинов.
    Was this useful?
    On this page

    On this page