Перейти до основного вмісту
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

Set the API key

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

Start searching

Агент автоматично використовуватиме Perplexity для вебпошуку після налаштування ключа. Додаткові кроки не потрібні.

​
Режими пошуку

Plugin автоматично вибирає транспорт на основі префікса ключа API:
Коли ваш ключ починається з pplx-, OpenClaw використовує нативний Perplexity Search API. Цей транспорт повертає структуровані результати та підтримує фільтри домену, мови й дати (див. параметри фільтрації нижче).
Префікс ключаТранспортМожливості
pplx-Нативний Perplexity Search APIСтруктуровані результати, фільтри домену/мови/дати
sk-or-OpenRouter (Sonar)Відповіді, синтезовані ШІ, з цитуваннями

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

Параметри фільтрації доступні лише під час використання нативного Perplexity API (ключ pplx-). Пошук OpenRouter/Sonar не підтримує ці параметри.
Під час використання нативного Perplexity API пошук підтримує такі фільтри:
ФільтрОписПриклад
Країна2-літерний код країни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 search tool

Як агент викликає пошук Perplexity та інтерпретує результати.

Configuration reference

Повний довідник конфігурації, зокрема записи Plugin.