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

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

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

1

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

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

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

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

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

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

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

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

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

Ключ, экспортированный только в интерактивной оболочке, недоступен демону Gateway, запущенному через launchd/systemd, если это окружение не импортировано явно. Укажите ключ в ~/.openclaw/.env или с помощью env.shellEnv, чтобы процесс Gateway мог прочитать его. Полный порядок приоритетов см. в разделе Переменные окружения.
Чтобы направлять поисковые запросы Perplexity через OpenRouter, укажите OPENROUTER_API_KEY (префикс sk-or-) вместо нативного ключа Perplexity. OpenClaw обнаружит ключ и автоматически переключится на транспорт Sonar. Это удобно, если вы уже настроили оплату в OpenRouter и хотите объединить там провайдеров.

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

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

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

Справочник по конфигурации

Полный справочник по конфигурации, включая записи плагинов.