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

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`, провайдер переключается на путь дополнений чата и вместо структурированных результатов Search API возвращает синтезированные ИИ ответы с цитатами.

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

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

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

## Получение ключа Perplexity API

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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "pplx-...",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "perplexity",
      },
    },
  },
}
```

### Совместимость с OpenRouter / Sonar

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "<openrouter-api-key>",
            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` (или окружение вашей службы). См. раздел [Переменные окружения](https://docs2.openclaw.ai/ru/help/faq.md#env-vars-and-env-loading).

Если настроен `provider: "perplexity"`, а SecretRef ключа Perplexity не разрешается и резервная переменная окружения отсутствует, запуск или перезагрузка немедленно завершается ошибкой.

## Параметры инструмента

Эти параметры применяются к нативному пути Perplexity Search API.

**query** `string` *required*

Поисковый запрос.

**count** `number` (default: 5)

Количество возвращаемых результатов (1-10).

**country** `string`

Двухбуквенный код страны ISO (например, `US`, `DE`).

**language** `string`

Код языка ISO 639-1 (например, `en`, `de`, `fr`).

**freshness** `'day' | 'week' | 'month' | 'year'`

Временной фильтр — `day` означает 24 часа.

**date\_after** `string`

Только результаты, опубликованные после этой даты (`YYYY-MM-DD`).

**date\_before** `string`

Только результаты, опубликованные до этой даты (`YYYY-MM-DD`).

**domain\_filter** `string[]`

Массив разрешённых или запрещённых доменов (не более 20).

**max\_tokens** `number` (default: 25000)

Общий бюджет содержимого (не более 1000000).

**max\_tokens\_per\_page** `number` (default: 2048)

Ограничение количества токенов на страницу.

Для устаревшего пути совместимости Sonar/OpenRouter:

* Поддерживаются `query`, `count` и `freshness`.
* `count` используется там только для совместимости; ответ по-прежнему представляет собой один синтезированный ответ с цитатами, а не список из N результатов.
* Фильтры, доступные только в Search API (`country`, `language`, `date_after`, `date_before`, `domain_filter`, `max_tokens`, `max_tokens_per_page`), приводят к явным ошибкам.

**Примеры:**

```javascript theme={"theme":{"light":"min-light","dark":"min-dark"}}
// Поиск с учётом страны и языка
await web_search({
  query: "возобновляемая энергия",
  country: "DE",
  language: "de",
});

// Недавние результаты (за последнюю неделю)
await web_search({
  query: "новости ИИ",
  freshness: "week",
});

// Поиск по диапазону дат
await web_search({
  query: "развитие ИИ",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Фильтрация доменов (список разрешённых)
await web_search({
  query: "исследования климата",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Фильтрация доменов (список запрещённых — с префиксом -)
await web_search({
  query: "обзоры продуктов",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// Извлечение большего объёма содержимого
await web_search({
  query: "подробные исследования ИИ",
  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 обратно на дополнения чата Sonar для совместимости.
* В режиме совместимости Sonar/OpenRouter возвращается один синтезированный ответ с цитатами, а не строки структурированных результатов.
* По умолчанию результаты кэшируются на 15 минут (настраивается с помощью `cacheTtlMinutes`).

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

> [card] [Обзор веб-поиска](https://docs2.openclaw.ai/ru/tools/web.md)
>
> Все провайдеры и правила автоматического обнаружения.

> [card] [Поиск Brave](https://docs2.openclaw.ai/ru/tools/brave-search.md)
>
> Структурированные результаты с фильтрами по стране и языку.

> [card] [Поиск Exa](https://docs2.openclaw.ai/ru/tools/exa-search.md)
>
> Нейронный поиск с извлечением содержимого.

> [card] [Документация Perplexity Search API](https://docs.perplexity.ai/docs/search/quickstart)
>
> Официальное краткое руководство и справочник по Perplexity Search API.