Pencarian Perplexity

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:

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

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

{  plugins: {    entries: {      perplexity: {        config: {          webSearch: {            apiKey: "pplx-...",          },        },      },    },  },  tools: {    web: {      search: {        provider: "perplexity",      },    },  },}

Kompatibilitas OpenRouter / Sonar

{  plugins: {    entries: {      perplexity: {        config: {          webSearch: {            apiKey: "<openrouter-api-key>",            baseUrl: "https://openrouter.ai/api/v1",            model: "perplexity/sonar-pro",          },        },      },    },  },  tools: {    web: {      search: {        provider: "perplexity",      },    },  },}

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.

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:

// Pencarian khusus negara dan bahasaawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Hasil terbaru (seminggu terakhir)await web_search({  query: "AI news",  freshness: "week",}); // Pencarian rentang tanggalawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Pemfilteran domain (daftar izin)await web_search({  query: "climate research",  domain_filter: ["nature.com", "science.org", ".edu"],}); // Pemfilteran domain (daftar blokir—awali dengan -)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // Ekstraksi konten lebih banyakawait web_search({  query: "detailed AI research",  max_tokens: 50000,  max_tokens_per_page: 4096,});

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