--- 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-07-13T18:43:40Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 24 provider: openai source_hash: a7ca97355110e70a05f1d57acab475dda8dec89393804df40c6e9be5e30780e8 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`, провайдер переключается на путь дополнений чата и вместо структурированных результатов Search API возвращает синтезированные ИИ ответы с цитатами. ## Установка плагина Установите официальный плагин, затем перезапустите Gateway: ```bash 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 { 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` (или окружение вашей службы). См. раздел [Переменные окружения](/ru/help/faq#env-vars-and-env-loading). Если настроен `provider: "perplexity"`, а SecretRef ключа Perplexity не разрешается и резервная переменная окружения отсутствует, запуск или перезагрузка немедленно завершается ошибкой. ## Параметры инструмента Эти параметры применяются к нативному пути Perplexity Search API. Поисковый запрос. Количество возвращаемых результатов (1-10). Двухбуквенный код страны 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 // Поиск с учётом страны и языка 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`). ## Связанные материалы Все провайдеры и правила автоматического обнаружения. Структурированные результаты с фильтрами по стране и языку. Нейронный поиск с извлечением содержимого. Официальное краткое руководство и справочник по Perplexity Search API.