Перейти к основному содержанию
Plugin Perplexity предоставляет возможности веб-поиска через Perplexity Search API или Perplexity Sonar через OpenRouter.
Эта страница описывает настройку поставщика Perplexity. О инструменте Perplexity (как агент его использует) см. инструмент Perplexity.
СвойствоЗначение
ТипПоставщик веб-поиска (не поставщик моделей)
АутентификацияPERPLEXITY_API_KEY (напрямую) или OPENROUTER_API_KEY (через OpenRouter)
Путь конфигурацииplugins.entries.perplexity.config.webSearch.apiKey

​
Установка Plugin

Установите официальный Plugin, затем перезапустите Gateway: 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

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

1

Задайте ключ API

Запустите интерактивный поток настройки веб-поиска:
openclaw configure --section web
Или задайте ключ напрямую:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

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

Агент будет автоматически использовать Perplexity для веб-поиска после настройки ключа. Дополнительные действия не требуются.

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

Plugin автоматически выбирает транспорт на основе префикса ключа API:
Если ваш ключ начинается с pplx-, OpenClaw использует нативный Perplexity Search API. Этот транспорт возвращает структурированные результаты и поддерживает фильтры по домену, языку и дате (см. параметры фильтрации ниже).
Префикс ключаТранспортВозможности
pplx-Нативный Perplexity Search APIСтруктурированные результаты, фильтры по домену/языку/дате
sk-or-OpenRouter (Sonar)Ответы, синтезированные ИИ, с цитатами

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

Параметры фильтрации доступны только при использовании нативного API Perplexity (ключ pplx-). Поиск через OpenRouter/Sonar не поддерживает эти параметры.
При использовании нативного API Perplexity поиск поддерживает следующие фильтры:
ФильтрОписаниеПример
СтранаДвухбуквенный код страныus, de, jp
ЯзыкКод языка ISO 639-1en, fr, zh
Диапазон датОкно давностиday, week, month, year
Фильтры доменовСписок разрешенных или запрещенных доменов (макс. 20 доменов)example.com
Бюджет содержимогоЛимиты токенов на ответ / на страницуmax_tokens, max_tokens_per_page

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

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

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

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

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

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

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