Providers
Perplexity
Plugin Perplexity قابلیتهای جستجوی وب را از طریق Perplexity Search API یا Perplexity Sonar از طریق OpenRouter فراهم میکند.
| ویژگی | مقدار |
|---|---|
| نوع | ارائهدهنده جستجوی وب (نه ارائهدهنده مدل) |
| احراز هویت | PERPLEXITY_API_KEY (مستقیم) یا OPENROUTER_API_KEY (از طریق OpenRouter) |
| مسیر پیکربندی | plugins.entries.perplexity.config.webSearch.apiKey |
نصب Plugin
Plugin رسمی را نصب کنید، سپس Gateway را راهاندازی مجدد کنید:
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 برای جستجوهای وب استفاده میکند. هیچ مرحله اضافی لازم نیست.
حالتهای جستجو
Plugin بر اساس پیشوند کلید API، انتقال را بهطور خودکار انتخاب میکند:
API بومی Perplexity (pplx-)
وقتی کلید شما با pplx- شروع میشود، OpenClaw از Perplexity Search
API بومی استفاده میکند. این انتقال نتایج ساختیافته برمیگرداند و از فیلترهای دامنه، زبان
و تاریخ پشتیبانی میکند (گزینههای فیلتر کردن را در ادامه ببینید).
OpenRouter / Sonar (sk-or-)
وقتی کلید شما با sk-or- شروع میشود، OpenClaw با استفاده از
مدل Perplexity Sonar از طریق OpenRouter مسیریابی میکند. این انتقال پاسخهای تولیدشده با هوش مصنوعی را همراه با
ارجاعها برمیگرداند.
| پیشوند کلید | انتقال | قابلیتها |
|---|---|---|
pplx- |
Perplexity Search API بومی | نتایج ساختیافته، فیلترهای دامنه/زبان/تاریخ |
sk-or- |
OpenRouter (Sonar) | پاسخهای تولیدشده با هوش مصنوعی همراه با ارجاعها |
فیلتر کردن API بومی
هنگام استفاده از API بومی Perplexity، جستجوها از فیلترهای زیر پشتیبانی میکنند:
| فیلتر | توضیح | مثال |
|---|---|---|
| کشور | کد دوحرفی کشور | us, de, jp |
| زبان | کد زبان ISO 639-1 | en, fr, zh |
| بازه تاریخ | پنجره تازگی | day, week, month, year |
| فیلترهای دامنه | فهرست مجاز یا فهرست مسدود (حداکثر ۲۰ دامنه) | example.com |
| بودجه محتوا | محدودیتهای توکن برای هر پاسخ / هر صفحه | max_tokens, max_tokens_per_page |
پیکربندی پیشرفته
متغیر محیطی برای فرایندهای daemon
اگر OpenClaw Gateway بهصورت daemon (launchd/systemd) اجرا میشود، مطمئن شوید
PERPLEXITY_API_KEY برای آن فرایند در دسترس است.
راهاندازی پراکسی OpenRouter
اگر ترجیح میدهید جستجوهای Perplexity را از طریق OpenRouter مسیریابی کنید، بهجای کلید بومی Perplexity
یک OPENROUTER_API_KEY (با پیشوند sk-or-) تنظیم کنید.
OpenClaw پیشوند را تشخیص میدهد و بهطور خودکار به انتقال Sonar
تغییر میدهد.
