--- read_when: - Ви хочете використовувати Perplexity Search для вебпошуку - Вам потрібно налаштувати PERPLEXITY_API_KEY або OPENROUTER_API_KEY summary: Perplexity Search API та сумісність Sonar/OpenRouter для web_search title: Пошук Perplexity x-i18n: generated_at: "2026-06-27T18:28:01Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 6ef003238bc38dd3d92b98654598cba05fb1c324d8ca766a683cf1defe5bd435 source_path: tools/perplexity-search.md workflow: 16 --- OpenClaw підтримує Perplexity Search API як провайдер `web_search`. Він повертає структуровані результати з полями `title`, `url` і `snippet`. Для сумісності OpenClaw також підтримує застарілі налаштування Perplexity Sonar/OpenRouter. Якщо ви використовуєте `OPENROUTER_API_KEY`, ключ `sk-or-...` у `plugins.entries.perplexity.config.webSearch.apiKey` або задаєте `plugins.entries.perplexity.config.webSearch.baseUrl` / `model`, провайдер перемикається на шлях chat-completions і повертає згенеровані ШІ відповіді з цитуваннями замість структурованих результатів Search API. ## Установлення Plugin Установіть офіційний Plugin, а потім перезапустіть Gateway: ```bash openclaw plugins install @openclaw/perplexity-plugin openclaw gateway restart ``` ## Отримання API-ключа Perplexity 1. Створіть обліковий запис Perplexity на [perplexity.ai/settings/api](https://www.perplexity.ai/settings/api) 2. Згенеруйте API-ключ на панелі керування 3. Збережіть ключ у конфігурації або задайте `PERPLEXITY_API_KEY` у середовищі Gateway. ## Сумісність з OpenRouter Якщо ви вже використовували OpenRouter для Perplexity Sonar, залиште `provider: "perplexity"` і задайте `OPENROUTER_API_KEY` у середовищі Gateway або збережіть ключ `sk-or-...` у `plugins.entries.perplexity.config.webSearch.apiKey`. Необов'язкові параметри керування сумісністю: - `plugins.entries.perplexity.config.webSearch.baseUrl` - `plugins.entries.perplexity.config.webSearch.model` ## Приклади конфігурації ### Нативний Perplexity Search API ```json5 { plugins: { entries: { perplexity: { config: { webSearch: { apiKey: "pplx-...", }, }, }, }, }, tools: { web: { search: { provider: "perplexity", }, }, }, } ``` ### Сумісність з OpenRouter / Sonar ```json5 { plugins: { entries: { perplexity: { config: { webSearch: { apiKey: "", baseUrl: "https://openrouter.ai/api/v1", model: "perplexity/sonar-pro", }, }, }, }, }, tools: { web: { search: { provider: "perplexity", }, }, }, } ``` ## Де задавати ключ **Через конфігурацію:** виконайте `openclaw configure --section web`. Команда зберігає ключ у `~/.openclaw/openclaw.json` у `plugins.entries.perplexity.config.webSearch.apiKey`. Це поле також приймає об'єкти SecretRef. **Через середовище:** задайте `PERPLEXITY_API_KEY` або `OPENROUTER_API_KEY` у середовищі процесу Gateway. Для встановлення gateway додайте його в `~/.openclaw/.env` (або у середовище вашого сервісу). Див. [змінні середовища](/uk/help/faq#env-vars-and-env-loading). Якщо налаштовано `provider: "perplexity"` і SecretRef ключа Perplexity не розв'язано без резервного значення з середовища, запуск/перезавантаження швидко завершується помилкою. ## Параметри інструмента Ці параметри застосовуються до нативного шляху Perplexity Search API. Пошуковий запит. Кількість результатів для повернення (1-10). 2-літерний код країни ISO (наприклад, `US`, `DE`). Код мови ISO 639-1 (наприклад, `en`, `de`, `fr`). Фільтр часу - `day` означає 24 години. Лише результати, опубліковані після цієї дати (`YYYY-MM-DD`). Лише результати, опубліковані до цієї дати (`YYYY-MM-DD`). Масив дозволених/заборонених доменів (максимум 20). Загальний бюджет вмісту (максимум 1000000). Ліміт токенів на сторінку. Для застарілого шляху сумісності Sonar/OpenRouter: - приймаються `query`, `count` і `freshness` - `count` там призначений лише для сумісності; відповідь усе одно є однією синтезованою відповіддю з цитуваннями, а не списком із N результатів - фільтри лише для Search API, як-от `country`, `language`, `date_after`, `date_before`, `domain_filter`, `max_tokens` і `max_tokens_per_page`, повертають явні помилки **Приклади:** ```javascript // Country and language-specific search await web_search({ query: "renewable energy", country: "DE", language: "de", }); // Recent results (past week) await web_search({ query: "AI news", freshness: "week", }); // Date range search await web_search({ query: "AI developments", date_after: "2024-01-01", date_before: "2024-06-30", }); // Domain filtering (allowlist) await web_search({ query: "climate research", domain_filter: ["nature.com", "science.org", ".edu"], }); // Domain filtering (denylist - prefix with -) await web_search({ query: "product reviews", domain_filter: ["-reddit.com", "-pinterest.com"], }); // More content extraction await web_search({ query: "detailed AI research", max_tokens: 50000, max_tokens_per_page: 4096, }); ``` ### Правила фільтра доменів - Максимум 20 доменів на фільтр - Не можна змішувати список дозволених і список заборонених доменів в одному запиті - Використовуйте префікс `-` для записів списку заборонених доменів (наприклад, `["-reddit.com"]`) ## Примітки - Perplexity Search API повертає структуровані результати вебпошуку (`title`, `url`, `snippet`) - OpenRouter або явні `plugins.entries.perplexity.config.webSearch.baseUrl` / `model` перемикають Perplexity назад на chat completions Sonar для сумісності - Сумісність Sonar/OpenRouter повертає одну синтезовану відповідь із цитуваннями, а не структуровані рядки результатів - Результати типово кешуються на 15 хвилин (налаштовується через `cacheTtlMinutes`) ## Пов'язане Усі провайдери та правила автовиявлення. Структуровані результати з фільтрами країни та мови. Нейронний пошук із витягуванням вмісту. Офіційний короткий посібник і довідник Perplexity Search API.