Perplexity araması

OpenClaw, Perplexity Search API'yi bir web_search sağlayıcısı olarak destekler. title, url ve snippet alanlarını içeren yapılandırılmış sonuçlar döndürür.

Uyumluluk amacıyla OpenClaw, 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 değerini 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:

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

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 değişkenini 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 değişkenini ayarlayın ya da 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

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

OpenRouter / Sonar uyumluluğu

{  plugins: {    entries: {      perplexity: {        config: {          webSearch: {            apiKey: "<openrouter-api-key>",            baseUrl: "https://openrouter.ai/api/v1",            model: "perplexity/sonar-pro",          },        },      },    },  },  tools: {    web: {      search: {        provider: "perplexity",      },    },  },}

Anahtarın ayarlanacağı yer

Yapılandırma aracılığıyla: openclaw configure --section web komutunu çalıştırın. Bu komut anahtarı ~/.openclaw/openclaw.json içinde plugins.entries.perplexity.config.webSearch.apiKey altında saklar. Bu alan SecretRef nesnelerini de kabul eder.

Ortam aracılığıyla: Gateway işleminin ortamında PERPLEXITY_API_KEY veya OPENROUTER_API_KEY değişkenini 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ı SecretRef'i çözümlenemiyorsa ve ortamda yedek değer yoksa başlatma/yeniden yükleme işlemi hemen başarısız olur.

Araç parametreleri

Bu parametreler yerel Perplexity Search API yolu için geçerlidir.

Eski Sonar/OpenRouter uyumluluk yolu için:

• query, count ve freshness kabul edilir.
• Burada count yalnızca uyumluluk içindir; yanıt yine de N sonuçlu bir liste yerine 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 hata iletileri döndürür.

Örnekler:

// Ülkeye ve dile özgü aramaawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Yakın tarihli sonuçlar (geçen hafta)await web_search({  query: "AI news",  freshness: "week",}); // Tarih aralığı aramasıawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Alan adı filtreleme (izin listesi)await web_search({  query: "climate research",  domain_filter: ["nature.com", "science.org", ".edu"],}); // Alan adı filtreleme (engelleme listesi: başına - ekleyin)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // Daha fazla içerik çıkarmaawait web_search({  query: "detailed AI research",  max_tokens: 50000,  max_tokens_per_page: 4096,});

Alan adı filtresi kuralları

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

Notlar

• Perplexity Search API, yapılandırılmış web araması sonuçları (title, url, snippet) döndürür.
• OpenRouter veya açıkça belirtilen bir plugins.entries.perplexity.config.webSearch.baseUrl / model değeri, 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