web_search. API ini mengembalikan hasil terstruktur dengan bidang title, url, dan snippet.
Untuk kompatibilitas, OpenClaw juga mendukung konfigurasi lama Perplexity Sonar/OpenRouter. Jika Anda menggunakan OPENROUTER_API_KEY, kunci sk-or-... di plugins.entries.perplexity.config.webSearch.apiKey, atau menetapkan plugins.entries.perplexity.config.webSearch.baseUrl / model, penyedia akan beralih ke jalur penyelesaian percakapan dan mengembalikan jawaban yang disintesis AI beserta kutipan, alih-alih hasil Search API terstruktur.
Instal Plugin
Instal Plugin resmi, lalu mulai ulang Gateway:Mendapatkan kunci API Perplexity
- Buat akun Perplexity di perplexity.ai/settings/api.
- Buat kunci API di dasbor.
- Simpan kunci dalam konfigurasi atau tetapkan
PERPLEXITY_API_KEYdi lingkungan Gateway.
Kompatibilitas OpenRouter
Jika Anda telah menggunakan OpenRouter untuk Perplexity Sonar, pertahankanprovider: "perplexity" dan tetapkan OPENROUTER_API_KEY di lingkungan Gateway, atau simpan kunci sk-or-... di plugins.entries.perplexity.config.webSearch.apiKey.
Kontrol kompatibilitas opsional:
plugins.entries.perplexity.config.webSearch.baseUrlplugins.entries.perplexity.config.webSearch.model
Contoh konfigurasi
Perplexity Search API asli
Kompatibilitas OpenRouter / Sonar
Tempat menetapkan kunci
Melalui konfigurasi: jalankanopenclaw configure --section web. Perintah ini menyimpan kunci di ~/.openclaw/openclaw.json pada plugins.entries.perplexity.config.webSearch.apiKey. Bidang tersebut juga menerima objek SecretRef.
Melalui lingkungan: tetapkan PERPLEXITY_API_KEY atau OPENROUTER_API_KEY di lingkungan proses Gateway. Untuk instalasi Gateway, letakkan di ~/.openclaw/.env (atau lingkungan layanan Anda). Lihat Variabel lingkungan.
Jika provider: "perplexity" dikonfigurasi dan SecretRef kunci Perplexity tidak dapat diurai tanpa nilai pengganti dari lingkungan, proses mulai ulang/pemuatan ulang akan segera gagal.
Parameter alat
Parameter ini berlaku untuk jalur Perplexity Search API asli.string
wajib
Kueri pencarian.
number
default:"5"
Jumlah hasil yang akan dikembalikan (1-10).
string
Kode negara ISO 2 huruf (misalnya
US, DE).string
Kode bahasa ISO 639-1 (misalnya
en, de, fr).'day' | 'week' | 'month' | 'year'
Filter waktu—
day berarti 24 jam.string
Hanya hasil yang diterbitkan setelah tanggal ini (
YYYY-MM-DD).string
Hanya hasil yang diterbitkan sebelum tanggal ini (
YYYY-MM-DD).string[]
Larik daftar izin/daftar blokir domain (maks. 20).
number
default:"25000"
Anggaran konten total (maks. 1000000).
number
default:"2048"
Batas token per halaman.
query,count, danfreshnessditerima.- Di jalur tersebut,
counthanya untuk kompatibilitas; responsnya tetap berupa satu jawaban yang disintesis beserta kutipan, bukan daftar berisi N hasil. - Filter khusus Search API (
country,language,date_after,date_before,domain_filter,max_tokens,max_tokens_per_page) mengembalikan galat eksplisit.
Aturan filter domain
- Maksimal 20 domain per filter.
- Entri daftar izin dan daftar blokir tidak dapat digabungkan dalam permintaan yang sama.
- Gunakan awalan
-untuk entri daftar blokir (misalnya["-reddit.com"]).
Catatan
- Perplexity Search API mengembalikan hasil pencarian web terstruktur (
title,url,snippet). - OpenRouter, atau
plugins.entries.perplexity.config.webSearch.baseUrl/modelyang ditetapkan secara eksplisit, mengalihkan Perplexity kembali ke penyelesaian percakapan Sonar demi kompatibilitas. - Kompatibilitas Sonar/OpenRouter mengembalikan satu jawaban yang disintesis beserta kutipan, bukan baris hasil terstruktur.
- Secara default, hasil disimpan dalam tembolok selama 15 menit (dapat dikonfigurasi melalui
cacheTtlMinutes).
Terkait
Ikhtisar pencarian web
Semua penyedia dan aturan deteksi otomatis.
Pencarian Brave
Hasil terstruktur dengan filter negara dan bahasa.
Pencarian Exa
Pencarian neural dengan ekstraksi konten.
Dokumentasi Perplexity Search API
Panduan memulai cepat dan referensi resmi Perplexity Search API.