Ana içeriğe atla
OpenClaw, web_search sağlayıcısı olarak Perplexity Search API’yi destekler. title, url ve snippet alanlarıyla yapılandırılmış sonuçlar döndürür. Uyumluluk için OpenClaw, eski Perplexity Sonar/OpenRouter kurulumlarını da destekler. OPENROUTER_API_KEY kullanırsanız, plugins.entries.perplexity.config.webSearch.apiKey içinde sk-or-... anahtarı kullanırsanız veya plugins.entries.perplexity.config.webSearch.baseUrl / model ayarlarsanız, sağlayıcı chat-completions yoluna geçer ve yapılandırılmış Search API sonuçları yerine alıntılarla AI tarafından sentezlenmiş yanıtlar döndürür.

​
Plugin’i yükle

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

​
Perplexity API anahtarı alma

  1. perplexity.ai/settings/api adresinde bir Perplexity hesabı oluşturun
  2. Panoda 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 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 nerede ayarlanır

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

​
Araç parametreleri

Bu parametreler yerel Perplexity Search API yolu için geçerlidir.
​
query
string
gerekli
Arama sorgusu.
​
count
number
varsayılan:"5"
Döndürülecek sonuç sayısı (1-10).
​
country
string
2 harfli ISO ülke kodu (örn. US, DE).
​
language
string
ISO 639-1 dil kodu (örn. en, de, fr).
​
freshness
'day' | 'week' | 'month' | 'year'
Zaman filtresi - day 24 saattir.
​
date_after
string
Yalnızca bu tarihten sonra yayımlanan sonuçlar (YYYY-MM-DD).
​
date_before
string
Yalnızca bu tarihten önce yayımlanan sonuçlar (YYYY-MM-DD).
​
domain_filter
string[]
Alan adı izin listesi/engelleme listesi dizisi (en fazla 20).
​
max_tokens
number
varsayılan:"25000"
Toplam içerik bütçesi (en fazla 1000000).
​
max_tokens_per_page
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 yine N sonuçlu bir liste yerine alıntılar içeren tek bir sentezlenmiş yanıttır
  • country, language, date_after, date_before, domain_filter, max_tokens ve max_tokens_per_page gibi yalnızca Search API’ye özgü filtreler açık hatalar döndürür
Örnekler: 
// Ülke ve dile özel arama
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Son 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 - önüne - koyun)
await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// Daha fazla içerik çıkarma
await 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ı
  • Aynı istekte izin listesi ve engelleme listesi karıştırılamaz
  • Engelleme listesi girdileri için - öneki kullanın (örn. ["-reddit.com"])

​
Notlar

  • Perplexity Search API, yapılandırılmış web arama sonuçları döndürür (title, url, snippet)
  • OpenRouter veya açık plugins.entries.perplexity.config.webSearch.baseUrl / model, uyumluluk için Perplexity’yi tekrar Sonar chat completions’a geçirir
  • Sonar/OpenRouter uyumluluğu, yapılandırılmış sonuç satırları değil, 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 ile yapılandırılabilir)

​
İlgili

Web aramasına genel bakış

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

Brave search

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

Exa search

İçerik çıkarma ile nöral arama.

Perplexity Search API belgeleri

Resmi Perplexity Search API hızlı başlangıcı ve başvurusu.