Perplexity

Perplexity 外掛會註冊一個 web_search 提供者，並提供兩種傳輸方式：原生 Perplexity Search API（具備篩選條件的結構化結果），以及直接或透過 OpenRouter 使用的 Perplexity Sonar 聊天補全（附引用來源的 AI 綜合答案）。

本頁說明 Perplexity 提供者的設定。如需了解 Perplexity 工具（代理如何使用它），請參閱 Perplexity 搜尋。

屬性	值
類型	網頁搜尋提供者（非模型提供者）
驗證	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-plugin
openclaw gateway restart

​

開始使用

1. 設定 API 金鑰

   openclaw configure --section web
   

   或直接設定金鑰：

   openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
   

   在閘道環境中匯出為 PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY 的金鑰也可使用。

2. 開始搜尋

   當 Perplexity 的金鑰是可用的搜尋認證資訊時，web_search 會自動偵測 Perplexity；不需要進一步設定。若要明確固定使用此提供者：

   openclaw config set tools.web.search.provider perplexity
   

​

搜尋模式

外掛會依下列順序決定傳輸方式：

1. webSearch.baseUrl 或 webSearch.model 已設定：無論金鑰類型為何，一律透過 Sonar 聊天補全路由至該端點。
2. 否則，由金鑰來源決定端點：已設定金鑰的前綴會選擇傳輸方式（設定優先於環境變數）；環境金鑰則直接使用其對應的端點。

金鑰前綴	傳輸方式	功能
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 結合使用。

​

進階設定

常駐程式的環境變數

僅在互動式 Shell 中匯出的金鑰，launchd/systemd 閘道常駐程式無法看見，除非明確匯入該環境。請在 ~/.openclaw/.env 中或透過 env.shellEnv 設定金鑰，讓閘道程序可以讀取。完整的優先順序請參閱環境變數。

OpenRouter Proxy 設定

若要透過 OpenRouter 路由 Perplexity 搜尋，請設定 OPENROUTER_API_KEY（前綴為 sk-or-），而非原生 Perplexity 金鑰。OpenClaw 會偵測金鑰並自動切換至 Sonar 傳輸方式。如果你已設定 OpenRouter 計費，並希望在該處整合提供者，這會很實用。

​

相關內容

Perplexity 搜尋工具

代理如何呼叫 Perplexity 搜尋並解讀結果。

設定參考

完整設定參考，包括外掛項目。