> ## 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

Плагин Perplexity регистрирует провайдера `web_search` с двумя транспортами:
нативным Perplexity Search API (структурированные результаты с фильтрами) и
чат-завершениями Perplexity Sonar напрямую или через OpenRouter (ответы,
синтезированные ИИ, с указанием источников).

> [!NOTE]
>
> На этой странице описана настройка **провайдера** Perplexity. Сведения об **инструменте** Perplexity (как агент использует его) см. в разделе [Поиск Perplexity](https://docs2.openclaw.ai/ru/tools/perplexity-search.md).

| Свойство | Значение |
| - | - |
| Тип | Провайдер веб-поиска (не провайдер моделей) |
| Аутентификация | `PERPLEXITY_API_KEY` (нативный) или `OPENROUTER_API_KEY` (через OpenRouter) |
| Путь конфигурации | `plugins.entries.perplexity.config.webSearch.apiKey` |
| Переопределения | `plugins.entries.perplexity.config.webSearch.baseUrl` / `.model` |
| Получение ключа | [perplexity.ai/settings/api](https://www.perplexity.ai/settings/api) |

## Установка плагина

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

## Начало работы

**1. Укажите ключ API**

```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"
```

Также можно экспортировать ключ как `PERPLEXITY_API_KEY` или `OPENROUTER_API_KEY`
в окружении Gateway.

**2. Начните поиск**

`web_search` автоматически обнаруживает Perplexity, когда его ключ является
доступными учётными данными для поиска; дополнительная настройка не требуется.
Чтобы явно закрепить провайдера:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set tools.web.search.provider perplexity
```

## Режимы поиска

Плагин определяет транспорт в следующем порядке:

1. `webSearch.baseUrl` или `webSearch.model` задан: запросы всегда направляются через чат-завершения Sonar к этой конечной точке независимо от типа ключа.
2. В противном случае конечную точку определяет источник ключа: префикс настроенного ключа выбирает транспорт (конфигурация имеет приоритет над переменными окружения); ключ из окружения напрямую использует соответствующую ему конечную точку.

| Префикс ключа | Транспорт | Возможности |
| - | - | - |
| `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` | Лимит содержимого для всех результатов / одной страницы | Только нативный |

Фильтры, доступные только для нативного транспорта, при использовании пути
чат-завершений возвращают информативную ошибку.
`freshness` нельзя сочетать с `date_after`/`date_before`.

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

> [accordion] Переменная окружения для фоновых процессов
>
> > [!WARNING]
> >
> > Ключ, экспортированный только в интерактивной оболочке, недоступен
> > демону Gateway, запущенному через launchd/systemd, если это окружение
> > не импортировано явно. Укажите ключ в `~/.openclaw/.env` или с помощью
> > `env.shellEnv`, чтобы процесс Gateway мог прочитать его. Полный порядок
> > приоритетов см. в разделе [Переменные окружения](https://docs2.openclaw.ai/ru/help/environment.md).

> [accordion] Настройка прокси OpenRouter
>
> Чтобы направлять поисковые запросы Perplexity через OpenRouter, укажите
> `OPENROUTER_API_KEY` (префикс `sk-or-`) вместо нативного ключа Perplexity.
> OpenClaw обнаружит ключ и автоматически переключится на транспорт Sonar. Это
> удобно, если вы уже настроили оплату в OpenRouter и хотите объединить там
> провайдеров.

## Связанные материалы

> [card] [Инструмент поиска Perplexity](https://docs2.openclaw.ai/ru/tools/perplexity-search.md)
>
> Как агент выполняет поиск через Perplexity и интерпретирует результаты.

> [card] [Справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/configuration-reference.md)
>
> Полный справочник по конфигурации, включая записи плагинов.