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
- perplexity.ai/settings/api adresinde bir Perplexity hesabı oluşturun.
- Kontrol panelinde bir API anahtarı oluşturun.
- Anahtarı yapılandırmada saklayın veya Gateway ortamında
PERPLEXITY_API_KEYayarlayın.
OpenRouter uyumluluğu
Perplexity Sonar için zaten OpenRouter kullanıyorsanızprovider: "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.baseUrlplugins.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ı.
query,countvefreshnesskabul edilir.countburada 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.
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 (
cacheTtlMinutesaracı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.