Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.
​
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[]
Domain 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ç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

Web aramasına genel bakış

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

Brave arama

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

Exa arama

İçerik çıkarımıyla sinirsel arama.

Perplexity Search API belgeleri

Resmi Perplexity Search API hızlı başlangıç ve başvuru bilgileri.