การค้นหา Perplexity

OpenClaw รองรับ Perplexity Search API ในฐานะผู้ให้บริการ web_search โดยจะส่งคืนผลลัพธ์แบบมีโครงสร้างพร้อมฟิลด์ title, url และ snippet

เพื่อความเข้ากันได้ OpenClaw ยังรองรับการตั้งค่า Perplexity Sonar/OpenRouter แบบเดิมด้วย หากคุณใช้ OPENROUTER_API_KEY, คีย์ sk-or-... ใน plugins.entries.perplexity.config.webSearch.apiKey หรือตั้งค่า plugins.entries.perplexity.config.webSearch.baseUrl / model ผู้ให้บริการจะสลับไปใช้เส้นทาง chat-completions และส่งคืนคำตอบที่ AI สังเคราะห์พร้อมการอ้างอิง แทนผลลัพธ์ Search API แบบมีโครงสร้าง

ติดตั้ง Plugin

ติดตั้ง Plugin อย่างเป็นทางการ แล้วรีสตาร์ท Gateway:

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

การรับคีย์ Perplexity API

1. สร้างบัญชี Perplexity ที่ perplexity.ai/settings/api
2. สร้างคีย์ API ในแดชบอร์ด
3. จัดเก็บคีย์ใน config หรือตั้งค่า PERPLEXITY_API_KEY ในสภาพแวดล้อมของ Gateway

ความเข้ากันได้กับ OpenRouter

หากคุณใช้ OpenRouter สำหรับ Perplexity Sonar อยู่แล้ว ให้คง provider: "perplexity" ไว้และตั้งค่า OPENROUTER_API_KEY ในสภาพแวดล้อมของ Gateway หรือจัดเก็บคีย์ sk-or-... ใน plugins.entries.perplexity.config.webSearch.apiKey

ตัวควบคุมความเข้ากันได้ที่เป็นตัวเลือก:

• plugins.entries.perplexity.config.webSearch.baseUrl
• plugins.entries.perplexity.config.webSearch.model

ตัวอย่าง config

Perplexity Search API แบบเนทีฟ

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

ความเข้ากันได้กับ 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",      },    },  },}

ตำแหน่งที่ตั้งค่าคีย์

ผ่าน config: รัน openclaw configure --section web คำสั่งนี้จะจัดเก็บคีย์ใน ~/.openclaw/openclaw.json ภายใต้ plugins.entries.perplexity.config.webSearch.apiKey ฟิลด์นั้นยังรับออบเจ็กต์ SecretRef ได้ด้วย

ผ่านสภาพแวดล้อม: ตั้งค่า PERPLEXITY_API_KEY หรือ OPENROUTER_API_KEY ในสภาพแวดล้อมของกระบวนการ Gateway สำหรับการติดตั้ง gateway ให้ใส่ไว้ใน ~/.openclaw/.env (หรือสภาพแวดล้อมของบริการของคุณ) ดู ตัวแปรสภาพแวดล้อม

หากมีการกำหนดค่า provider: "perplexity" และ SecretRef ของคีย์ Perplexity ไม่สามารถ resolve ได้โดยไม่มี env fallback การเริ่มต้น/โหลดใหม่จะล้มเหลวทันที

พารามิเตอร์ของเครื่องมือ

พารามิเตอร์เหล่านี้ใช้กับเส้นทาง Perplexity Search API แบบเนทีฟ

สำหรับเส้นทางความเข้ากันได้ของ Sonar/OpenRouter แบบเดิม:

• รองรับ query, count และ freshness
• count ใช้เพื่อความเข้ากันได้เท่านั้นในเส้นทางนั้น; การตอบกลับยังคงเป็นคำตอบสังเคราะห์หนึ่งรายการพร้อมการอ้างอิง แทนที่จะเป็นรายการผลลัพธ์ N รายการ
• ตัวกรองที่มีเฉพาะใน Search API เช่น country, language, date_after, date_before, domain_filter, max_tokens และ max_tokens_per_page จะส่งคืนข้อผิดพลาดที่ชัดเจน

ตัวอย่าง:

// Country and language-specific searchawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Recent results (past week)await web_search({  query: "AI news",  freshness: "week",}); // Date range searchawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // Domain filtering (allowlist)await web_search({  query: "climate research",  domain_filter: ["nature.com", "science.org", ".edu"],}); // Domain filtering (denylist - prefix with -)await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // More content extractionawait web_search({  query: "detailed AI research",  max_tokens: 50000,  max_tokens_per_page: 4096,});

กฎของตัวกรองโดเมน

• สูงสุด 20 โดเมนต่อตัวกรอง
• ไม่สามารถผสม allowlist และ denylist ในคำขอเดียวกันได้
• ใช้คำนำหน้า - สำหรับรายการ denylist (เช่น ["-reddit.com"])

หมายเหตุ

• Perplexity Search API ส่งคืนผลลัพธ์การค้นหาเว็บแบบมีโครงสร้าง (title, url, snippet)
• OpenRouter หรือ plugins.entries.perplexity.config.webSearch.baseUrl / model ที่ระบุอย่างชัดเจนจะสลับ Perplexity กลับไปใช้ Sonar chat completions เพื่อความเข้ากันได้
• ความเข้ากันได้ของ Sonar/OpenRouter ส่งคืนคำตอบสังเคราะห์หนึ่งรายการพร้อมการอ้างอิง ไม่ใช่แถวผลลัพธ์แบบมีโครงสร้าง
• ผลลัพธ์จะถูกแคชไว้ 15 นาทีตามค่าเริ่มต้น (กำหนดค่าได้ผ่าน cacheTtlMinutes)

ที่เกี่ยวข้อง