Ana içeriğe atla
Perplexity Plugin, Perplexity Search API veya OpenRouter üzerinden Perplexity Sonar aracılığıyla web araması özellikleri sağlar.
Bu sayfa Perplexity sağlayıcı kurulumudur. Perplexity aracı için (ajanın bunu nasıl kullandığı), bkz. Perplexity aracı.
ÖzellikDeğer
TürWeb araması sağlayıcısı (model sağlayıcısı değil)
Kimlik doğrulamaPERPLEXITY_API_KEY (doğrudan) veya OPENROUTER_API_KEY (OpenRouter üzerinden)
Yapılandırma yoluplugins.entries.perplexity.config.webSearch.apiKey

​
Plugin yükleme

Resmi Plugin’i yükleyin, ardından Gateway’i yeniden başlatın: 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​
Başlarken

1

API anahtarını ayarlayın

Etkileşimli web araması yapılandırma akışını çalıştırın:
openclaw configure --section web
Veya anahtarı doğrudan ayarlayın:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

Aramaya başlayın

Anahtar yapılandırıldıktan sonra ajan, web aramaları için Perplexity’yi otomatik olarak kullanır. Ek adım gerekmez.

​
Arama modları

Plugin, API anahtarı önekine göre taşıma katmanını otomatik seçer:
Anahtarınız pplx- ile başladığında OpenClaw, yerel Perplexity Search API’yi kullanır. Bu taşıma katmanı yapılandırılmış sonuçlar döndürür ve etki alanı, dil ve tarih filtrelerini destekler (aşağıdaki filtreleme seçeneklerine bakın).
Anahtar önekiTaşıma katmanıÖzellikler
pplx-Yerel Perplexity Search APIYapılandırılmış sonuçlar, etki alanı/dil/tarih filtreleri
sk-or-OpenRouter (Sonar)Alıntılarla yapay zeka tarafından sentezlenmiş yanıtlar

​
Yerel API filtreleme

Filtreleme seçenekleri yalnızca yerel Perplexity API kullanılırken (pplx- anahtarı) kullanılabilir. OpenRouter/Sonar aramaları bu parametreleri desteklemez.
Yerel Perplexity API kullanıldığında, aramalar aşağıdaki filtreleri destekler:
FiltreAçıklamaÖrnek
Ülke2 harfli ülke koduus, de, jp
DilISO 639-1 dil koduen, fr, zh
Tarih aralığıGüncellik penceresiday, week, month, year
Etki alanı filtreleriİzin listesi veya engelleme listesi (en fazla 20 etki alanı)example.com
İçerik bütçesiYanıt başına / sayfa başına token sınırlarımax_tokens, max_tokens_per_page

​
Gelişmiş yapılandırma

OpenClaw Gateway bir daemon (launchd/systemd) olarak çalışıyorsa, PERPLEXITY_API_KEY değerinin bu süreç için kullanılabilir olduğundan emin olun.
Yalnızca etkileşimli bir shell içinde dışa aktarılan bir anahtar, bu ortam açıkça içe aktarılmadığı sürece launchd/systemd daemon tarafından görülemez. Gateway sürecinin okuyabilmesini sağlamak için anahtarı ~/.openclaw/.env içinde veya env.shellEnv aracılığıyla ayarlayın.
Perplexity aramalarını OpenRouter üzerinden yönlendirmeyi tercih ediyorsanız, yerel Perplexity anahtarı yerine bir OPENROUTER_API_KEY (sk-or- öneki) ayarlayın. OpenClaw öneki algılar ve otomatik olarak Sonar taşıma katmanına geçer.
Zaten bir OpenRouter hesabınız varsa ve birden fazla sağlayıcıda birleştirilmiş faturalandırma istiyorsanız OpenRouter taşıma katmanı kullanışlıdır.

​
İlgili

Perplexity arama aracı

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

Yapılandırma referansı

Plugin girişleri dahil tam yapılandırma referansı.