Skip to main content
OpenClaw, Perplexity Search API’yi bir web_search sağlayıcısı olarak destekler. title, url ve snippet alanlarıyla yapılandırılmış sonuçlar döndürür. OpenClaw, uyumluluk amacıyla eski Perplexity Sonar/OpenRouter kurulumlarını da destekler. OPENROUTER_API_KEY kullanırsanız, plugins.entries.perplexity.config.webSearch.apiKey içinde bir sk-or-... anahtarı kullanırsanız veya plugins.entries.perplexity.config.webSearch.baseUrl / model ayarlarsanız sağlayıcı, sohbet tamamlama yoluna geçer ve yapılandırılmış Search API sonuçları yerine alıntılar içeren, yapay zekâ tarafından sentezlenmiş yanıtlar döndürür.

Plugin’i yükleme

Resmî Plugin’i yükleyin, ardından Gateway’i yeniden başlatın:

Perplexity API anahtarı alma

  1. perplexity.ai/settings/api adresinde bir Perplexity hesabı oluşturun.
  2. Kontrol panelinde bir API anahtarı oluşturun.
  3. Anahtarı yapılandırmada saklayın veya Gateway ortamında PERPLEXITY_API_KEY ayarlayın.

OpenRouter uyumluluğu

Perplexity Sonar için zaten OpenRouter kullanıyorsanız provider: "perplexity" değerini koruyun ve Gateway ortamında OPENROUTER_API_KEY ayarlayın veya plugins.entries.perplexity.config.webSearch.apiKey içinde bir sk-or-... anahtarı saklayın. İsteğe bağlı uyumluluk denetimleri:
  • plugins.entries.perplexity.config.webSearch.baseUrl
  • plugins.entries.perplexity.config.webSearch.model

Yapılandırma örnekleri

Yerel Perplexity Search API

OpenRouter / Sonar uyumluluğu

Anahtarın ayarlanacağı yer

Yapılandırma aracılığıyla: openclaw configure --section web komutunu çalıştırın. Bu komut, anahtarı plugins.entries.perplexity.config.webSearch.apiKey altında ~/.openclaw/openclaw.json içinde saklar. Bu alan SecretRef nesnelerini de kabul eder. Ortam aracılığıyla: Gateway işlem ortamında PERPLEXITY_API_KEY veya OPENROUTER_API_KEY ayarlayın. Bir Gateway kurulumu için bunu ~/.openclaw/.env dosyasına (veya hizmet ortamınıza) ekleyin. Bkz. Ortam değişkenleri. provider: "perplexity" yapılandırılmışsa ve Perplexity anahtarının SecretRef’i çözümlenemiyorsa ve ortam geri dönüşü yoksa başlatma/yeniden yükleme hızlıca başarısız olur.

Araç parametreleri

Bu parametreler yerel Perplexity Search API yolu için geçerlidir.
string
gerekli
Arama sorgusu.
number
varsayılan:"5"
Döndürülecek sonuç sayısı (1-10).
string
2 harfli ISO ülke kodu (ör. US, DE).
string
ISO 639-1 dil kodu (ör. en, de, fr).
'day' | 'week' | 'month' | 'year'
Zaman filtresi - day 24 saattir.
string
Yalnızca bu tarihten sonra yayımlanan sonuçlar (YYYY-MM-DD).
string
Yalnızca bu tarihten önce yayımlanan sonuçlar (YYYY-MM-DD).
string[]
Etki alanı izin listesi/engelleme listesi dizisi (en fazla 20).
number
varsayılan:"25000"
Toplam içerik bütçesi (en fazla 1000000).
number
varsayılan:"2048"
Sayfa başına token sınırı.
Eski Sonar/OpenRouter uyumluluk yolu için:
  • query, count ve freshness kabul edilir.
  • count burada yalnızca uyumluluk içindir; yanıt, N sonuçlu bir liste yerine yine alıntılar içeren tek bir sentezlenmiş yanıttır.
  • Yalnızca Search API’ye özgü filtreler (country, language, date_after, date_before, domain_filter, max_tokens, max_tokens_per_page) açık hatalar döndürür.
Örnekler:

Etki alanı filtresi kuralları

  • Filtre başına en fazla 20 etki alanı.
  • Aynı istekte izin listesi ve engelleme listesi girdileri birlikte kullanılamaz.
  • Engelleme listesi girdileri için - önekini kullanın (ör. ["-reddit.com"]).

Notlar

  • Perplexity Search API, yapılandırılmış web araması sonuçları döndürür (title, url, snippet).
  • OpenRouter veya açıkça belirtilmiş bir plugins.entries.perplexity.config.webSearch.baseUrl / model, uyumluluk amacıyla Perplexity’yi yeniden Sonar sohbet tamamlamalarına geçirir.
  • Sonar/OpenRouter uyumluluğu, yapılandırılmış sonuç satırları yerine alıntılar içeren tek bir sentezlenmiş yanıt döndürür.
  • Sonuçlar varsayılan olarak 15 dakika önbelleğe alınır (cacheTtlMinutes aracılığıyla yapılandırılabilir).

İlgili

Web aramasına genel bakış

Tüm sağlayıcılar ve otomatik algılama kuralları.

Brave araması

Ülke ve dil filtreleriyle yapılandırılmış sonuçlar.

Exa araması

İçerik çıkarma özellikli sinir ağı tabanlı arama.

Perplexity Search API belgeleri

Resmî Perplexity Search API hızlı başlangıç kılavuzu ve başvuru belgeleri.