Langsung ke konten utama

​
Perplexity (Provider Pencarian Web)

Plugin Perplexity menyediakan kapabilitas pencarian web melalui Perplexity Search API atau Perplexity Sonar melalui OpenRouter.
Halaman ini membahas setup provider Perplexity. Untuk tool Perplexity (bagaimana agen menggunakannya), lihat Tool Perplexity.
PropertiNilai
TipeProvider pencarian web (bukan provider model)
AuthPERPLEXITY_API_KEY (langsung) atau OPENROUTER_API_KEY (melalui OpenRouter)
Path configplugins.entries.perplexity.config.webSearch.apiKey

​
Memulai

1

Atur API key

Jalankan flow konfigurasi pencarian web interaktif:
openclaw configure --section web
Atau atur key secara langsung:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

Mulai mencari

Agen akan otomatis menggunakan Perplexity untuk pencarian web setelah key dikonfigurasi. Tidak diperlukan langkah tambahan.

​
Mode pencarian

Plugin otomatis memilih transport berdasarkan prefiks API key:
Saat key Anda diawali dengan pplx-, OpenClaw menggunakan Perplexity Search API native. Transport ini mengembalikan hasil terstruktur dan mendukung filter domain, bahasa, dan tanggal (lihat opsi pemfilteran di bawah).
Prefiks keyTransportFitur
pplx-Native Perplexity Search APIHasil terstruktur, filter domain/bahasa/tanggal
sk-or-OpenRouter (Sonar)Jawaban yang disintesis AI dengan sitasi

​
Pemfilteran Native API

Opsi pemfilteran hanya tersedia saat menggunakan Native Perplexity API (key pplx-). Pencarian OpenRouter/Sonar tidak mendukung parameter ini.
Saat menggunakan Native Perplexity API, pencarian mendukung filter berikut:
FilterDeskripsiContoh
NegaraKode negara 2 hurufus, de, jp
BahasaKode bahasa ISO 639-1en, fr, zh
Rentang tanggalJendela kekinianday, week, month, year
Filter domainAllowlist atau denylist (maks 20 domain)example.com
Anggaran kontenBatas token per respons / per halamanmax_tokens, max_tokens_per_page

​
Catatan lanjutan

Jika OpenClaw Gateway berjalan sebagai daemon (launchd/systemd), pastikan PERPLEXITY_API_KEY tersedia untuk proses tersebut.
Key yang hanya diatur di ~/.profile tidak akan terlihat oleh daemon launchd/systemd kecuali environment tersebut diimpor secara eksplisit. Atur key di ~/.openclaw/.env atau melalui env.shellEnv untuk memastikan proses gateway dapat membacanya.
Jika Anda lebih memilih merutekan pencarian Perplexity melalui OpenRouter, atur OPENROUTER_API_KEY (prefiks sk-or-) alih-alih key Perplexity native. OpenClaw akan mendeteksi prefiks tersebut dan otomatis beralih ke transport Sonar.
Transport OpenRouter berguna jika Anda sudah memiliki akun OpenRouter dan menginginkan penagihan terpusat di beberapa provider.

​
Terkait

Tool pencarian Perplexity

Cara agen memanggil pencarian Perplexity dan menafsirkan hasilnya.

Referensi konfigurasi

Referensi konfigurasi lengkap termasuk entri plugin.