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

​
Установите Plugin

Установите официальный Plugin, затем перезапустите Gateway: 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

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

  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.
​
query
string
обязательно
Поисковый запрос.
​
count
number
по умолчанию:"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
по умолчанию:"25000"
Общий бюджет содержимого (максимум 1000000).
​
max_tokens_per_page
number
по умолчанию:"2048"
Лимит токенов на страницу.
Для устаревшего пути совместимости Sonar/OpenRouter:
  • принимаются query, count и freshness
  • count там предназначен только для совместимости; ответ все равно представляет собой один синтезированный ответ с цитированием, а не список из N результатов
  • фильтры только для Search API, такие как country, language, date_after, date_before, domain_filter, max_tokens и max_tokens_per_page, возвращают явные ошибки
Примеры: 
// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Domain filtering (allowlist)
await web_search({
  query: "climate research",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Domain filtering (denylist - prefix with -)
await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// More content extraction
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 обратно на chat completions Sonar для совместимости
  • Совместимость Sonar/OpenRouter возвращает один синтезированный ответ с цитированием, а не строки структурированных результатов
  • Результаты по умолчанию кэшируются на 15 минут (настраивается через cacheTtlMinutes)

​
См. также

Web search overview

Все провайдеры и правила автоопределения.

Brave search

Структурированные результаты с фильтрами по стране и языку.

Exa search

Нейронный поиск с извлечением содержимого.

Perplexity Search API docs

Официальное краткое руководство и справочник Perplexity Search API.