OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Perplexity

Perplexity Plugin'i, iki aktarım yöntemiyle bir web_search sağlayıcısı kaydeder: yerel Perplexity Search API (filtreli yapılandırılmış sonuçlar) ve doğrudan ya da OpenRouter üzerinden Perplexity Sonar sohbet tamamlamaları (atıflar içeren, yapay zekâ tarafından sentezlenmiş yanıtlar).

Özellik Değer
Tür Web araması sağlayıcısı (model sağlayıcısı değildir)
Kimlik doğrulama PERPLEXITY_API_KEY (yerel) veya OPENROUTER_API_KEY (OpenRouter üzerinden)
Yapılandırma yolu plugins.entries.perplexity.config.webSearch.apiKey
Geçersiz kılmalar plugins.entries.perplexity.config.webSearch.baseUrl / .model
Anahtar edinme perplexity.ai/settings/api

Plugin'i yükleme

bash
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Başlangıç

  • API anahtarını ayarlayın

    bash
    openclaw configure --section web

    Alternatif olarak anahtarı doğrudan ayarlayın:

    bash
    openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"

    Gateway ortamında PERPLEXITY_API_KEY veya OPENROUTER_API_KEY olarak dışa aktarılan bir anahtar da çalışır.

  • Aramaya başlayın

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

    bash
    openclaw config set tools.web.search.provider perplexity

    • Arama modları

    Plugin, aktarım yöntemini şu sırayla belirler:

    1. webSearch.baseUrl veya webSearch.model ayarlanmışsa: anahtar türünden bağımsız olarak her zaman ilgili uç noktadaki Sonar sohbet tamamlamaları üzerinden yönlendirir.
    2. Aksi takdirde anahtarın kaynağı uç noktayı belirler: yapılandırılmış bir anahtarın ön eki aktarım yöntemini 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.
    Anahtar ön eki Aktarım yöntemi Özellikler
    pplx- Yerel Perplexity Search API (https://api.perplexity.ai) Yapılandırılmış sonuçlar, alan adı/dil/tarih filtreleri
    sk-or- OpenRouter (https://openrouter.ai/api/v1), Sonar modeli Atıflar içeren, yapay zekâ tarafından sentezlenmiş yanıtlar

    Başka bir ön eke sahip yapılandırılmış anahtar da yerel Search API'yi 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ılabilirsiniz.

    Yerel API filtreleme

    Filtre Açıklama Aktarım yöntemi
    count Arama başına sonuç sayısı, 1-10 (varsayılan 5) Yalnızca yerel
    freshness Güncellik aralığı: day, week, month, year Her ikisi
    country 2 harfli ülke kodu (us, de, jp) Yalnızca yerel
    language ISO 639-1 dil kodu (en, fr, zh) Yalnızca yerel
    date_after / date_before YYYY-MM-DD biçiminde yayımlanma tarihi aralığı Yalnızca yerel
    domain_filter En fazla 20 alan adı; izin listesi veya - ön ekli engelleme listesi, ikisi asla birlikte kullanılamaz Yalnızca yerel
    max_tokens / max_tokens_per_page Tüm sonuçlar / sayfa başına içerik bütçesi Yalnızca yerel

    Yalnızca yerel aktarım yönteminde kullanılabilen 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

    Daemon işlemleri için ortam değişkeni
    OpenRouter proxy kurulumu

    Perplexity aramalarını OpenRouter üzerinden yönlendirmek için yerel Perplexity anahtarı yerine bir OPENROUTER_API_KEY (ön ek sk-or-) ayarlayın. OpenClaw anahtarı algılar ve otomatik olarak Sonar aktarım yöntemine geçer. OpenRouter faturalandırmasını önceden ayarladıysanız ve sağlayıcıları burada birleştirmek istiyorsanız kullanışlıdır.

    İlgili içerikler

    Perplexity arama aracı

    Temsilcinin Perplexity aramalarını nasıl çağırdığı ve sonuçları nasıl yorumladığı.
    Yapılandırma başvurusu

    Plugin girdileri dâhil olmak üzere tam yapılandırma başvurusu.
    Was this useful?
    On this page

    On this page