Skip to main content
OpenClaw mendukung Perplexity Search API sebagai penyedia 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

  1. Buat akun Perplexity di perplexity.ai/settings/api.
  2. Buat kunci API di dasbor.
  3. Simpan kunci dalam konfigurasi atau tetapkan PERPLEXITY_API_KEY di lingkungan Gateway.

Kompatibilitas OpenRouter

Jika Anda telah menggunakan OpenRouter untuk Perplexity Sonar, pertahankan provider: "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.baseUrl
  • plugins.entries.perplexity.config.webSearch.model

Contoh konfigurasi

Perplexity Search API asli

Kompatibilitas OpenRouter / Sonar

Tempat menetapkan kunci

Melalui konfigurasi: jalankan openclaw 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.
Untuk jalur kompatibilitas lama Sonar/OpenRouter:
  • query, count, dan freshness diterima.
  • Di jalur tersebut, count hanya 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.
Contoh:

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 / model yang 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.