Providers
Perplexity
Perplexity 外掛會註冊一個 web_search 提供者，並提供兩種傳輸方式：原生 Perplexity Search API（具備篩選條件的結構化結果），以及直接或透過 OpenRouter 使用的 Perplexity Sonar 聊天補全（附引用來源的 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 |
安裝外掛
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 的金鑰也可使用。
開始搜尋
當 Perplexity 的金鑰是可用的搜尋認證資訊時，web_search 會自動偵測 Perplexity；不需要進一步設定。若要明確固定使用此提供者：
openclaw config set tools.web.search.provider perplexity搜尋模式
外掛會依下列順序決定傳輸方式：
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 Proxy 設定
若要透過 OpenRouter 路由 Perplexity 搜尋，請設定 OPENROUTER_API_KEY（前綴為 sk-or-），而非原生 Perplexity 金鑰。OpenClaw 會偵測金鑰並自動切換至 Sonar 傳輸方式。如果你已設定 OpenRouter 計費，並希望在該處整合提供者，這會很實用。
相關內容
Was this useful?
