OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Perplexity

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).

Properti Nilai
Jenis Penyedia pencarian web (bukan penyedia model)
Autentikasi PERPLEXITY_API_KEY (native) atau OPENROUTER_API_KEY (melalui OpenRouter)
Jalur konfigurasi plugins.entries.perplexity.config.webSearch.apiKey
Penimpaan plugins.entries.perplexity.config.webSearch.baseUrl / .model
Dapatkan kunci perplexity.ai/settings/api

Instal Plugin

bash
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Memulai

  • Tetapkan kunci API

    bash
    openclaw configure --section web

    Atau tetapkan kunci secara langsung:

    bash
    openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"

    Kunci yang diekspor sebagai PERPLEXITY_API_KEY atau OPENROUTER_API_KEY di lingkungan Gateway juga dapat digunakan.

  • 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:

    bash
    openclaw config set tools.web.search.provider perplexity

    • 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.
    Prefiks kunci Transport Fitur
    pplx- Perplexity Search API native (https://api.perplexity.ai) Hasil terstruktur, filter domain/bahasa/tanggal
    sk-or- OpenRouter (https://openrouter.ai/api/v1), model Sonar Jawaban hasil sintesis AI dengan kutipan

    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 Deskripsi Transport
    count Hasil per pencarian, 1–10 (default 5) Hanya native
    freshness Rentang kebaruan: day, week, month, year Keduanya
    country Kode negara 2 huruf (us, de, jp) Hanya native
    language Kode bahasa ISO 639-1 (en, fr, zh) Hanya native
    date_after / date_before Rentang tanggal publikasi dalam YYYY-MM-DD Hanya native
    domain_filter Maks. 20 domain; daftar izin atau daftar tolak berprefiks -, tidak boleh dicampur Hanya native
    max_tokens / max_tokens_per_page Anggaran konten untuk semua hasil / per halaman Hanya native

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

    Konfigurasi lanjutan

    Variabel lingkungan untuk proses daemon
    Penyiapan proksi OpenRouter

    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.
    Was this useful?
    On this page

    On this page