Skip to main content
Perplexity Plugin’i, iki aktarım mekanizmasına sahip bir web_search sağlayıcısı kaydeder: yerel Perplexity Search API’si (filtreli yapılandırılmış sonuçlar) ve doğrudan ya da OpenRouter üzerinden Perplexity Sonar sohbet tamamlamaları (alıntılar içeren, yapay zekâ tarafından sentezlenmiş yanıtlar).
Bu sayfa Perplexity sağlayıcı kurulumunu ele alır. Perplexity aracı (agent’ın bunu nasıl kullandığı) için Perplexity araması bölümüne bakın.

​
Plugin’i yükleme

​
Başlarken

1

API anahtarını ayarlayın

Alternatif olarak anahtarı doğrudan ayarlayın:
Gateway ortamında PERPLEXITY_API_KEY veya OPENROUTER_API_KEY olarak dışa aktarılan bir anahtar da çalışır.
2

Aramaya başlayın

web_search, anahtarı kullanılabilir arama kimlik bilgisi olduğunda Perplexity’yi otomatik olarak algılar; başka bir kurulum gerekmez. Sağlayıcıyı açıkça sabitlemek için:

​
Arama modları

Plugin, aktarım mekanizmasını şu sırayla çözümler:
  1. webSearch.baseUrl veya webSearch.model ayarlanmışsa: anahtar türünden bağımsız olarak her zaman söz konusu uç noktaya yönelik Sonar sohbet tamamlamaları üzerinden yönlendirir.
  2. Aksi takdirde uç noktayı anahtarın kaynağı belirler: yapılandırılmış bir anahtarın ön eki aktarım mekanizmasını seçer (yapılandırma, ortam değişkenlerine göre önceliklidir); ortam anahtarı ise doğrudan eşleşen uç noktasını kullanır.
Başka herhangi bir ön eke sahip yapılandırılmış anahtar da yerel Search API’sini kullanır. Sohbet tamamlamaları yolu varsayılan olarak perplexity/sonar-pro modelini kullanır; bunu plugins.entries.perplexity.config.webSearch.model ile geçersiz kılın.

​
Yerel API filtreleme

Yalnızca yerel aktarıma özgü filtreler, sohbet tamamlamaları yolunda açıklayıcı bir hata döndürür. freshness, date_after/date_before ile birlikte kullanılamaz.

​
Gelişmiş yapılandırma

Yalnızca etkileşimli bir kabukta dışa aktarılan anahtar, söz konusu ortam açıkça içe aktarılmadığı sürece launchd/systemd Gateway daemon’ı tarafından görülemez. Gateway işleminin anahtarı okuyabilmesi için anahtarı ~/.openclaw/.env içinde veya env.shellEnv aracılığıyla ayarlayın. Tam öncelik sırası için Ortam değişkenleri bölümüne bakın.
Perplexity aramalarını OpenRouter üzerinden yönlendirmek için yerel Perplexity anahtarı yerine bir OPENROUTER_API_KEY (sk-or- ön ekli) ayarlayın. OpenClaw anahtarı algılar ve otomatik olarak Sonar aktarım mekanizmasına geçer. OpenRouter faturalandırmasını zaten ayarladıysanız ve sağlayıcıları burada birleştirmek istiyorsanız kullanışlıdır.

​
İlgili

Perplexity arama aracı

Agent’ın Perplexity aramalarını nasıl çağırdığı ve sonuçları nasıl yorumladığı.

Yapılandırma başvurusu

Plugin girdileri dâhil tam yapılandırma başvurusu.