Пошук 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.

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

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

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Отримання ключа Perplexity API

1. Створіть обліковий запис Perplexity на сторінці 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

{  plugins: {    entries: {      perplexity: {        config: {          webSearch: {            apiKey: "pplx-...",          },        },      },    },  },  tools: {    web: {      search: {        provider: "perplexity",      },    },  },}

Сумісність з OpenRouter / Sonar

{  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 (або до середовища вашої служби). Див. Змінні середовища.

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

Параметри інструмента

Ці параметри застосовуються до нативного шляху Perplexity Search API.

Для застарілого шляху сумісності Sonar/OpenRouter:

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

Приклади:

// Пошук за країною та мовоюawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Нещодавні результати (за останній тиждень)await web_search({  query: "AI news",  freshness: "week",}); // Пошук за діапазоном датawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Фільтрування доменів (список дозволених)await web_search({  query: "climate research",  domain_filter: ["nature.com", "science.org", ".edu"],}); // Фільтрування доменів (список заборонених — із префіксом -)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // Розширене вилучення вмісту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 назад на завершення чату Sonar для сумісності.
• Режим сумісності Sonar/OpenRouter повертає одну синтезовану відповідь із посиланнями на джерела, а не структуровані рядки результатів.
• За замовчуванням результати кешуються на 15 хвилин (це можна налаштувати через cacheTtlMinutes).

Пов’язані матеріали