> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Perplexity

Plugin Perplexity надає можливості вебпошуку через Perplexity
Search API або Perplexity Sonar через OpenRouter.

<Note>
  Ця сторінка описує налаштування **провайдера** Perplexity. Для **інструмента** Perplexity (як агент його використовує) див. [інструмент Perplexity](/uk/tools/perplexity-search).
</Note>

| Властивість       | Значення                                                                   |
| ----------------- | -------------------------------------------------------------------------- |
| Тип               | Провайдер вебпошуку (не провайдер моделей)                                 |
| Автентифікація    | `PERPLEXITY_API_KEY` (напряму) або `OPENROUTER_API_KEY` (через OpenRouter) |
| Шлях конфігурації | `plugins.entries.perplexity.config.webSearch.apiKey`                       |

## Установлення Plugin

Установіть офіційний Plugin, потім перезапустіть Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart
```

## Початок роботи

<Steps>
  <Step title="Set the API key">
    Запустіть інтерактивний потік конфігурації вебпошуку:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    ```

    Або задайте ключ напряму:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
    ```
  </Step>

  <Step title="Start searching">
    Агент автоматично використовуватиме Perplexity для вебпошуку після
    налаштування ключа. Додаткові кроки не потрібні.
  </Step>
</Steps>

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

Plugin автоматично вибирає транспорт на основі префікса ключа API:

<Tabs>
  <Tab title="Native Perplexity API (pplx-)">
    Коли ваш ключ починається з `pplx-`, OpenClaw використовує нативний Perplexity Search
    API. Цей транспорт повертає структуровані результати та підтримує фільтри домену, мови
    й дати (див. параметри фільтрації нижче).
  </Tab>

  <Tab title="OpenRouter / Sonar (sk-or-)">
    Коли ваш ключ починається з `sk-or-`, OpenClaw спрямовує запити через OpenRouter за допомогою
    моделі Perplexity Sonar. Цей транспорт повертає відповіді, синтезовані ШІ, з
    цитуваннями.
  </Tab>
</Tabs>

| Префікс ключа | Транспорт                      | Можливості                                         |
| ------------- | ------------------------------ | -------------------------------------------------- |
| `pplx-`       | Нативний Perplexity Search API | Структуровані результати, фільтри домену/мови/дати |
| `sk-or-`      | OpenRouter (Sonar)             | Відповіді, синтезовані ШІ, з цитуваннями           |

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

<Note>
  Параметри фільтрації доступні лише під час використання нативного Perplexity API
  (ключ `pplx-`). Пошук OpenRouter/Sonar не підтримує ці параметри.
</Note>

Під час використання нативного Perplexity API пошук підтримує такі фільтри:

| Фільтр          | Опис                                                 | Приклад                             |
| --------------- | ---------------------------------------------------- | ----------------------------------- |
| Країна          | 2-літерний код країни                                | `us`, `de`, `jp`                    |
| Мова            | Код мови ISO 639-1                                   | `en`, `fr`, `zh`                    |
| Діапазон дат    | Вікно актуальності                                   | `day`, `week`, `month`, `year`      |
| Фільтри доменів | Список дозволених або заборонених (макс. 20 доменів) | `example.com`                       |
| Бюджет вмісту   | Ліміти токенів на відповідь / на сторінку            | `max_tokens`, `max_tokens_per_page` |

## Розширена конфігурація

<AccordionGroup>
  <Accordion title="Environment variable for daemon processes">
    Якщо OpenClaw Gateway працює як демон (launchd/systemd), переконайтеся, що
    `PERPLEXITY_API_KEY` доступний цьому процесу.

    <Warning>
      Ключ, експортований лише в інтерактивній оболонці, не буде видимий для
      демона launchd/systemd, якщо це середовище не імпортовано явно. Задайте
      ключ у `~/.openclaw/.env` або через `env.shellEnv`, щоб процес gateway
      міг його прочитати.
    </Warning>
  </Accordion>

  <Accordion title="OpenRouter proxy setup">
    Якщо ви хочете спрямовувати пошуки Perplexity через OpenRouter, задайте
    `OPENROUTER_API_KEY` (префікс `sk-or-`) замість нативного ключа Perplexity.
    OpenClaw виявить префікс і автоматично перемкнеться на транспорт Sonar.

    <Tip>
      Транспорт OpenRouter корисний, якщо у вас уже є обліковий запис OpenRouter
      і ви хочете консолідовану оплату для кількох провайдерів.
    </Tip>
  </Accordion>
</AccordionGroup>

## Пов’язане

<CardGroup cols={2}>
  <Card title="Perplexity search tool" href="/uk/tools/perplexity-search" icon="magnifying-glass">
    Як агент викликає пошук Perplexity та інтерпретує результати.
  </Card>

  <Card title="Configuration reference" href="/uk/gateway/configuration-reference" icon="gear">
    Повний довідник конфігурації, зокрема записи Plugin.
  </Card>
</CardGroup>