Wyszukiwanie Perplexity

OpenClaw obsługuje interfejs Perplexity Search API jako dostawcę web_search. Zwraca on uporządkowane wyniki z polami title, url i snippet.

W celu zapewnienia zgodności OpenClaw obsługuje również starsze konfiguracje Perplexity Sonar/OpenRouter. Jeśli używasz OPENROUTER_API_KEY, klucza sk-or-... w plugins.entries.perplexity.config.webSearch.apiKey albo ustawisz plugins.entries.perplexity.config.webSearch.baseUrl / model, dostawca przełącza się na ścieżkę uzupełnień czatu i zamiast uporządkowanych wyników Search API zwraca odpowiedzi zsyntetyzowane przez AI wraz z cytowaniami.

Instalowanie pluginu

Zainstaluj oficjalny plugin, a następnie uruchom ponownie Gateway:

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Uzyskiwanie klucza API Perplexity

1. Utwórz konto Perplexity na stronie perplexity.ai/settings/api.
2. Wygeneruj klucz API w panelu.
3. Zapisz klucz w konfiguracji lub ustaw PERPLEXITY_API_KEY w środowisku Gateway.

Zgodność z OpenRouter

Jeśli używasz już OpenRouter z Perplexity Sonar, pozostaw provider: "perplexity" i ustaw OPENROUTER_API_KEY w środowisku Gateway albo zapisz klucz sk-or-... w plugins.entries.perplexity.config.webSearch.apiKey.

Opcjonalne ustawienia zgodności:

• plugins.entries.perplexity.config.webSearch.baseUrl
• plugins.entries.perplexity.config.webSearch.model

Przykłady konfiguracji

Natywny interfejs Perplexity Search API

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

Zgodność z 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",      },    },  },}

Gdzie ustawić klucz

Za pomocą konfiguracji: uruchom openclaw configure --section web. Polecenie zapisze klucz w ~/.openclaw/openclaw.json w polu plugins.entries.perplexity.config.webSearch.apiKey. To pole akceptuje również obiekty SecretRef.

Za pomocą środowiska: ustaw PERPLEXITY_API_KEY lub OPENROUTER_API_KEY w środowisku procesu Gateway. W przypadku instalacji Gateway umieść go w ~/.openclaw/.env (lub w środowisku usługi). Zobacz Zmienne środowiskowe.

Jeśli skonfigurowano provider: "perplexity", a odwołanie SecretRef do klucza Perplexity pozostaje nierozwiązane i nie ma wartości zastępczej w środowisku, uruchamianie lub ponowne wczytywanie natychmiast kończy się niepowodzeniem.

Parametry narzędzia

Te parametry dotyczą natywnej ścieżki Perplexity Search API.

W przypadku starszej ścieżki zgodności z Sonar/OpenRouter:

• Akceptowane są query, count i freshness.
• count służy tam wyłącznie do zapewnienia zgodności; odpowiedź nadal jest jedną zsyntetyzowaną odpowiedzią z cytowaniami, a nie listą N wyników.
• Filtry dostępne wyłącznie w Search API (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page) zwracają jednoznaczne błędy.

Przykłady:

// Wyszukiwanie z określonym krajem i językiemawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Najnowsze wyniki (z ostatniego tygodnia)await web_search({  query: "AI news",  freshness: "week",}); // Wyszukiwanie w zakresie datawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Filtrowanie domen (lista dozwolonych)await web_search({  query: "climate research",  domain_filter: ["nature.com", "science.org", ".edu"],}); // Filtrowanie domen (lista zabronionych — prefiks -)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // Pobieranie większej ilości treściawait web_search({  query: "detailed AI research",  max_tokens: 50000,  max_tokens_per_page: 4096,});

Reguły filtrowania domen

• Maksymalnie 20 domen na filtr.
• W jednym żądaniu nie można łączyć wpisów listy dozwolonych i listy zabronionych.
• W przypadku wpisów listy zabronionych użyj prefiksu - (np. ["-reddit.com"]).

Uwagi

• Perplexity Search API zwraca uporządkowane wyniki wyszukiwania internetowego (title, url, snippet).
• OpenRouter lub jawne ustawienie plugins.entries.perplexity.config.webSearch.baseUrl / model przełącza Perplexity z powrotem na uzupełnienia czatu Sonar w celu zapewnienia zgodności.
• Tryb zgodności z Sonar/OpenRouter zwraca jedną zsyntetyzowaną odpowiedź z cytowaniami, a nie uporządkowane wiersze wyników.
• Wyniki są domyślnie przechowywane w pamięci podręcznej przez 15 minut (wartość można skonfigurować za pomocą cacheTtlMinutes).

Powiązane