Perplexity araması

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, 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ı chat-completions yoluna geçer ve yapılandırılmış Search API sonuçları yerine alıntılar içeren yapay zeka tarafından sentezlenmiş yanıtlar döndürür.

# 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 kontrolleri:

• 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 yoluyla: openclaw configure --section web komutunu çalıştırın. Anahtarı plugins.entries.perplexity.config.webSearch.apiKey altında ~/.openclaw/openclaw.json içinde saklar. Bu alan SecretRef nesnelerini de kabul eder.

Ortam yoluyla: Gateway süreç ortamında PERPLEXITY_API_KEY veya OPENROUTER_API_KEY ayarlayın. Bir gateway kurulumu için bunu ~/.openclaw/.env içine (veya servis ortamınıza) koyun. Bkz. Ortam değişkenleri.

provider: "perplexity" yapılandırılmışsa ve Perplexity anahtar SecretRef'i env yedeği olmadan çözümlenmemişse başlangıç/yeniden yükleme hızlı şekilde başarısız olur.

# Araç parametreleri

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

querystringrequired

Arama sorgusu.

countnumber

Döndürülecek sonuç sayısı (1-10).

countrystring

2 harfli ISO ülke kodu (örn. US, DE).

languagestring

ISO 639-1 dil kodu (örn. en, de, fr).

freshness'day' | 'week' | 'month' | 'year'

Zaman filtresi - day 24 saattir.

date_afterstring

Yalnızca bu tarihten sonra yayımlanan sonuçlar (YYYY-MM-DD).

date_beforestring

Yalnızca bu tarihten önce yayımlanan sonuçlar (YYYY-MM-DD).

domain_filterstring[]

Domain izin listesi/engelleme listesi dizisi (en fazla 20).

max_tokensnumber

Toplam içerik bütçesi (en fazla 1000000).

max_tokens_per_pagenumber

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çluk 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:

// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Domain filtering (allowlist)
await web_search({
  query: "climate research",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Domain filtering (denylist - prefix with -)
await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// More content extraction
await web_search({
  query: "detailed AI research",
  max_tokens: 50000,
  max_tokens_per_page: 4096,
});

# Domain filtresi kuralları

• Filtre başına en fazla 20 domain
• Aynı istekte izin listesi ve engelleme listesi karıştırılamaz
• Engelleme listesi girişleri için - önekini kullanın (örn. ["-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 plugins.entries.perplexity.config.webSearch.baseUrl / model, uyumluluk için Perplexity'yi tekrar Sonar chat completions yoluna 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