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

Фільтри, доступні лише для нативного 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 та інтерпретує результати.

Довідник із конфігурації

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