Langsung ke konten utama
Plugin Perplexity menyediakan kemampuan pencarian web melalui Perplexity Search API atau Perplexity Sonar melalui OpenRouter.
Halaman ini adalah penyiapan provider Perplexity. Untuk alat Perplexity (cara agen menggunakannya), lihat alat Perplexity.
PropertiNilai
TipeProvider pencarian web (bukan provider model)
AuthPERPLEXITY_API_KEY (langsung) atau OPENROUTER_API_KEY (melalui OpenRouter)
Jalur configplugins.entries.perplexity.config.webSearch.apiKey

​
Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway: 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​
Memulai

1

Atur kunci API

Jalankan alur konfigurasi pencarian web interaktif:
openclaw configure --section web
Atau atur kunci 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 kunci dikonfigurasi. Tidak diperlukan langkah tambahan.

​
Mode pencarian

Plugin otomatis memilih transport berdasarkan prefiks kunci API:
Ketika kunci Anda dimulai 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 kunciTransportFitur
pplx-Perplexity Search API nativeHasil terstruktur, filter domain/bahasa/tanggal
sk-or-OpenRouter (Sonar)Jawaban yang disintesis AI dengan sitasi

​
Pemfilteran API native

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

​
Konfigurasi lanjutan

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

​
Terkait

Alat pencarian Perplexity

Cara agen memanggil pencarian Perplexity dan menafsirkan hasil.

Referensi konfigurasi

Referensi konfigurasi lengkap termasuk entri Plugin.