Providers
پرپلکسیتی
Plugin Perplexity یک ارائهدهندهٔ web_search را با دو روش انتقال ثبت میکند: API بومی جستوجوی Perplexity (نتایج ساختاریافته با فیلترها) و تکمیلهای چت Sonar Perplexity، بهصورت مستقیم یا از طریق OpenRouter (پاسخهای ترکیبشده با هوش مصنوعی همراه با ارجاعات).
| ویژگی | مقدار |
|---|---|
| نوع | ارائهدهندهٔ جستوجوی وب (نه ارائهدهندهٔ مدل) |
| احراز هویت | PERPLEXITY_API_KEY (بومی) یا OPENROUTER_API_KEY (از طریق OpenRouter) |
| مسیر پیکربندی | plugins.entries.perplexity.config.webSearch.apiKey |
| بازنویسیها | plugins.entries.perplexity.config.webSearch.baseUrl / .model |
| دریافت کلید | perplexity.ai/settings/api |
نصب Plugin
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restartشروع کار
تنظیم کلید API
openclaw configure --section webیا کلید را مستقیماً تنظیم کنید:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"کلیدی که با نام PERPLEXITY_API_KEY یا OPENROUTER_API_KEY در محیط Gateway
صادر شده باشد نیز کار میکند.
شروع جستوجو
وقتی کلید Perplexity بهعنوان اعتبارنامهٔ جستوجوی موجود باشد، web_search آن را بهطور خودکار شناسایی میکند؛ راهاندازی دیگری لازم نیست. برای تثبیت صریح ارائهدهنده:
openclaw config set tools.web.search.provider perplexityحالتهای جستوجو
Plugin روش انتقال را بهترتیب زیر تعیین میکند:
webSearch.baseUrlیاwebSearch.modelتنظیم شده باشد: صرفنظر از نوع کلید، همیشه تکمیلهای چت Sonar را از طریق آن نقطهٔ پایانی مسیریابی میکند.- در غیر این صورت، منبع کلید نقطهٔ پایانی را تعیین میکند: پیشوند کلید پیکربندیشده روش انتقال را انتخاب میکند (پیکربندی بر متغیرهای محیطی اولویت دارد)؛ کلید محیطی مستقیماً از نقطهٔ پایانی متناظر خود استفاده میکند.
| پیشوند کلید | روش انتقال | قابلیتها |
|---|---|---|
pplx- |
API بومی جستوجوی Perplexity (https://api.perplexity.ai) |
نتایج ساختاریافته، فیلترهای دامنه/زبان/تاریخ |
sk-or- |
OpenRouter (https://openrouter.ai/api/v1)، مدل Sonar |
پاسخهای ترکیبشده با هوش مصنوعی همراه با ارجاعات |
کلید پیکربندیشده با هر پیشوند دیگری نیز از API بومی جستوجو استفاده میکند. مسیر تکمیلهای چت بهطور پیشفرض از مدل perplexity/sonar-pro استفاده میکند؛ آن را با plugins.entries.perplexity.config.webSearch.model بازنویسی کنید.
فیلترگذاری API بومی
| فیلتر | توضیحات | روش انتقال |
|---|---|---|
count |
تعداد نتایج در هر جستوجو، 1-10 (پیشفرض 5) | فقط بومی |
freshness |
بازهٔ تازگی: day، week، month، year |
هر دو |
country |
کد دوحرفی کشور (us، de، jp) |
فقط بومی |
language |
کد زبان ISO 639-1 (en، fr، zh) |
فقط بومی |
date_after / date_before |
بازهٔ تاریخ انتشار در YYYY-MM-DD |
فقط بومی |
domain_filter |
حداکثر 20 دامنه؛ فهرست مجاز یا فهرست مسدود با پیشوند -، هرگز بهصورت ترکیبی |
فقط بومی |
max_tokens / max_tokens_per_page |
بودجهٔ محتوا برای همهٔ نتایج / برای هر صفحه | فقط بومی |
فیلترهای مختص حالت بومی در مسیر تکمیلهای چت، خطایی توصیفی برمیگردانند.
freshness را نمیتوان با date_after/date_before ترکیب کرد.
پیکربندی پیشرفته
متغیر محیطی برای فرایندهای daemon
راهاندازی پراکسی OpenRouter
برای مسیریابی جستوجوهای Perplexity از طریق OpenRouter، بهجای کلید بومی Perplexity یک OPENROUTER_API_KEY
(با پیشوند sk-or-) تنظیم کنید. OpenClaw کلید را شناسایی میکند و
بهطور خودکار به روش انتقال Sonar تغییر میدهد. این گزینه زمانی مفید است که
صورتحساب OpenRouter را از قبل راهاندازی کردهاید و میخواهید ارائهدهندگان را در آنجا یکپارچه کنید.
