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 |
Встановлення плагіна
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restartПочаток роботи
Установіть ключ API
openclaw configure --section webАбо встановіть ключ безпосередньо:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"Також можна використовувати ключ, експортований як PERPLEXITY_API_KEY або
OPENROUTER_API_KEY у середовищі Gateway.
Почніть пошук
web_search автоматично виявляє Perplexity, щойно його ключ стає доступними
обліковими даними для пошуку; додаткове налаштування не потрібне. Щоб явно
закріпити постачальника:
openclaw config set tools.web.search.provider perplexityРежими пошуку
Плагін визначає транспорт у такому порядку:
- Установлено
webSearch.baseUrlабоwebSearch.model: запити завжди спрямовуються через завершення чату Sonar до цієї кінцевої точки незалежно від типу ключа. - В іншому разі джерело ключа визначає кінцеву точку: префікс налаштованого ключа визначає транспорт (конфігурація має пріоритет над змінними середовища); ключ із середовища безпосередньо використовує відповідну йому кінцеву точку.
| Префікс ключа | Транспорт | Можливості |
|---|---|---|
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 |
Бюджет вмісту для всіх результатів / для кожної сторінки | Лише нативний |
Фільтри, доступні лише для нативного API, повертають описову помилку на шляху
завершень чату. freshness не можна поєднувати з date_after/date_before.
Розширена конфігурація
Змінна середовища для процесів-демонів
Налаштування проксі OpenRouter
Щоб спрямовувати пошукові запити Perplexity через OpenRouter, установіть
OPENROUTER_API_KEY (префікс sk-or-) замість нативного ключа Perplexity.
OpenClaw виявить ключ і автоматично перемкнеться на транспорт Sonar. Це корисно,
якщо ви вже налаштували оплату OpenRouter і хочете об’єднати там постачальників.
