Поиск Perplexity

​

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

openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​

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

1. Создайте учётную запись Perplexity на странице perplexity.ai/settings/api.
2. Создайте ключ API на панели управления.
3. Сохраните ключ в конфигурации или задайте PERPLEXITY_API_KEY в окружении Gateway.

​

Совместимость с OpenRouter

• 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",
      },
    },
  },
}

​

Где задать ключ

​

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

• Поддерживаются 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: "возобновляемая энергия",
  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).

​

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