Skip to main content
Plugin Perplexity mendaftarkan penyedia web_search dengan dua transport: Perplexity Search API native (hasil terstruktur dengan filter) dan penyelesaian percakapan Perplexity Sonar, secara langsung atau melalui OpenRouter (jawaban hasil sintesis AI dengan kutipan).
Halaman ini membahas penyiapan penyedia Perplexity. Untuk alat Perplexity (cara agen menggunakannya), lihat Pencarian Perplexity.

​
Instal Plugin

​
Memulai

1

Tetapkan kunci API

Atau tetapkan kunci secara langsung:
Kunci yang diekspor sebagai PERPLEXITY_API_KEY atau OPENROUTER_API_KEY di lingkungan Gateway juga dapat digunakan.
2

Mulai mencari

web_search mendeteksi Perplexity secara otomatis setelah kuncinya menjadi kredensial pencarian yang tersedia; tidak diperlukan penyiapan lebih lanjut. Untuk menetapkan penyedia secara eksplisit:

​
Mode pencarian

Plugin menentukan transport dalam urutan berikut:
  1. webSearch.baseUrl atau webSearch.model ditetapkan: selalu merutekan melalui penyelesaian percakapan Sonar ke titik akhir tersebut, apa pun jenis kuncinya.
  2. Jika tidak, sumber kunci menentukan titik akhir: prefiks kunci yang dikonfigurasi memilih transport (konfigurasi mengalahkan variabel lingkungan); kunci lingkungan langsung menggunakan titik akhir yang sesuai.
Kunci yang dikonfigurasi dengan prefiks lain juga menggunakan Search API native. Jalur penyelesaian percakapan secara default menggunakan model perplexity/sonar-pro; timpa dengan plugins.entries.perplexity.config.webSearch.model.

​
Pemfilteran API native

Filter khusus native mengembalikan galat deskriptif pada jalur penyelesaian percakapan. freshness tidak dapat digabungkan dengan date_after/date_before.

​
Konfigurasi lanjutan

Kunci yang hanya diekspor di shell interaktif tidak terlihat oleh daemon Gateway launchd/systemd kecuali lingkungan tersebut diimpor secara eksplisit. Tetapkan kunci di ~/.openclaw/.env atau melalui env.shellEnv agar proses Gateway dapat membacanya. Lihat Variabel lingkungan untuk urutan prioritas lengkap.
Untuk merutekan pencarian Perplexity melalui OpenRouter, tetapkan OPENROUTER_API_KEY (prefiks sk-or-) sebagai pengganti kunci native Perplexity. OpenClaw mendeteksi kunci tersebut dan secara otomatis beralih ke transport Sonar. Ini berguna jika Anda sudah menyiapkan penagihan OpenRouter dan ingin menggabungkan penyedia di sana.

​
Terkait

Alat pencarian Perplexity

Cara agen menjalankan pencarian Perplexity dan menafsirkan hasilnya.

Referensi konfigurasi

Referensi konfigurasi lengkap, termasuk entri Plugin.