Providers
Perplexity
Plugin Perplexity ลงทะเบียนผู้ให้บริการ web_search พร้อมวิธีรับส่งข้อมูลสองแบบ ได้แก่ Perplexity Search API แบบเนทีฟ (ผลลัพธ์แบบมีโครงสร้างพร้อมตัวกรอง) และการเติมข้อความสนทนา Perplexity Sonar ทั้งแบบเชื่อมต่อโดยตรงหรือผ่าน OpenRouter (คำตอบที่ AI สังเคราะห์พร้อมการอ้างอิง)
| คุณสมบัติ | ค่า |
|---|---|
| ประเภท | ผู้ให้บริการค้นหาเว็บ (ไม่ใช่ผู้ให้บริการโมเดล) |
| การยืนยันตัวตน | 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 ได้เช่นกัน
เริ่มค้นหา
web_search จะตรวจหา Perplexity โดยอัตโนมัติเมื่อคีย์ของ Perplexity เป็นข้อมูลประจำตัวสำหรับการค้นหาที่พร้อมใช้งาน โดยไม่ต้องตั้งค่าเพิ่มเติม หากต้องการกำหนดผู้ให้บริการอย่างชัดเจน:
openclaw config set tools.web.search.provider perplexityโหมดการค้นหา
Plugin จะกำหนดวิธีรับส่งข้อมูลตามลำดับต่อไปนี้:
- มีการตั้งค่า
webSearch.baseUrlหรือwebSearch.model: กำหนดเส้นทางผ่านการเติมข้อความสนทนา Sonar ไปยังปลายทางนั้นเสมอ โดยไม่คำนึงถึงประเภทคีย์ - มิฉะนั้น แหล่งที่มาของคีย์จะเป็นตัวกำหนดปลายทาง: คำนำหน้าของคีย์ที่กำหนดค่าไว้จะเลือกวิธีรับส่งข้อมูล (ค่ากำหนดมีลำดับความสำคัญเหนือกว่าตัวแปรสภาพแวดล้อม) ส่วนคีย์จากสภาพแวดล้อมจะใช้ปลายทางที่ตรงกันโดยตรง
| คำนำหน้าคีย์ | วิธีรับส่งข้อมูล | ความสามารถ |
|---|---|---|
pplx- |
Perplexity Search API แบบเนทีฟ (https://api.perplexity.ai) |
ผลลัพธ์แบบมีโครงสร้าง ตัวกรองโดเมน/ภาษา/วันที่ |
sk-or- |
OpenRouter (https://openrouter.ai/api/v1), โมเดล Sonar |
คำตอบที่ AI สังเคราะห์พร้อมการอ้างอิง |
คีย์ที่กำหนดค่าไว้ซึ่งมีคำนำหน้าอื่นจะใช้ Search API แบบเนทีฟเช่นกัน พาธการเติมข้อความสนทนาจะใช้โมเดล perplexity/sonar-pro เป็นค่าเริ่มต้น โดยเขียนทับได้ด้วย plugins.entries.perplexity.config.webSearch.model
การกรองของ API แบบเนทีฟ
| ตัวกรอง | คำอธิบาย | วิธีรับส่งข้อมูล |
|---|---|---|
count |
จำนวนผลลัพธ์ต่อการค้นหา 1-10 (ค่าเริ่มต้น 5) | แบบเนทีฟเท่านั้น |
freshness |
ช่วงเวลาความใหม่: day, week, month, year |
ทั้งสองแบบ |
country |
รหัสประเทศ 2 ตัวอักษร (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 ได้
การกำหนดค่าขั้นสูง
ตัวแปรสภาพแวดล้อมสำหรับกระบวนการดีมอน
การตั้งค่าพร็อกซี OpenRouter
หากต้องการกำหนดเส้นทางการค้นหาด้วย Perplexity ผ่าน OpenRouter ให้ตั้งค่า OPENROUTER_API_KEY (คำนำหน้า sk-or-) แทนคีย์ Perplexity แบบเนทีฟ OpenClaw จะตรวจหาคีย์และเปลี่ยนไปใช้วิธีรับส่งข้อมูล Sonar โดยอัตโนมัติ ซึ่งมีประโยชน์หากคุณตั้งค่าการเรียกเก็บเงินของ OpenRouter ไว้แล้วและต้องการรวมผู้ให้บริการไว้ที่นั่น