Providers
Perplexity
افزونه 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 |
نصب افزونه
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restartشروع به کار
تنظیم کلید API
openclaw configure --section webیا کلید را مستقیماً تنظیم کنید:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"کلیدی که در محیط Gateway با نام PERPLEXITY_API_KEY یا OPENROUTER_API_KEY صادر شده باشد نیز کار میکند.
شروع جستوجو
هنگامی که کلید Perplexity اعتبارنامه جستوجوی موجود باشد، web_search آن را بهطور خودکار شناسایی میکند؛ به راهاندازی بیشتری نیاز نیست. برای تعیین صریح ارائهدهنده:
openclaw config set tools.web.search.provider perplexityحالتهای جستوجو
افزونه روش انتقال را به ترتیب زیر تعیین میکند:
- اگر
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 |
تعداد نتایج در هر جستوجو، ۱ تا ۱۰ (پیشفرض ۵) | فقط بومی |
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 |
حداکثر ۲۰ دامنه؛ فهرست مجاز یا فهرست مسدود با پیشوند -، هرگز ترکیبی نیستند |
فقط بومی |
max_tokens / max_tokens_per_page |
بودجه محتوا برای همه نتایج / برای هر صفحه | فقط بومی |
فیلترهای مختص API بومی در مسیر تکمیلهای گفتوگو خطایی توصیفی برمیگردانند. freshness را نمیتوان با date_after/date_before ترکیب کرد.
پیکربندی پیشرفته
متغیر محیطی برای فرایندهای پسزمینه
راهاندازی پراکسی OpenRouter
برای هدایت جستوجوهای Perplexity از طریق OpenRouter، بهجای کلید بومی Perplexity یک OPENROUTER_API_KEY (با پیشوند sk-or-) تنظیم کنید. OpenClaw کلید را شناسایی میکند و بهطور خودکار به روش انتقال Sonar تغییر میدهد. این کار زمانی مفید است که از قبل صورتحساب OpenRouter را راهاندازی کردهاید و میخواهید ارائهدهندگان را در آنجا یکپارچه کنید.
