Skip to main content
Perplexity 插件注册了一个 web_search 提供方，提供两种传输方式：原生 Perplexity Search API（带过滤器的结构化结果）以及 Perplexity Sonar 聊天补全，可直接使用或通过 OpenRouter 使用（带引用的 AI 综合回答）。
本页介绍 Perplexity 提供方 的设置。关于 Perplexity 工具（代理如何使用它），请参见 Perplexity search。

​
安装插件

​
入门

1

设置 API 密钥

或直接设置密钥：
在 Gateway 环境中导出为 PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY 的密钥也可以使用。
2

开始搜索

web_search 一旦检测到 Perplexity 密钥是可用的搜索凭据，就会自动识别 Perplexity；无需进一步设置。若要显式固定提供方：

​
搜索模式

该插件按以下顺序解析传输方式：
  1. 已设置 webSearch.baseUrl 或 webSearch.model：始终通过该端点的 Sonar chat completions 路由，而不管密钥类型如何。
  2. 否则，由密钥来源决定端点：已配置密钥的前缀决定传输方式（配置优先于环境变量）；环境密钥则直接使用其匹配的端点。
任何其他前缀的已配置密钥也会使用原生 Search API。chat-completions 路径默认使用 perplexity/sonar-pro 模型；可通过 plugins.entries.perplexity.config.webSearch.model 覆盖。

​
原生 API 过滤

仅原生的过滤器在 chat-completions 路径上会返回描述性错误。 freshness 不能与 date_after/date_before 组合使用。

​
高级配置

仅在交互式 shell 中导出的密钥对 launchd/systemd Gateway 守护进程不可见，除非显式导入该环境。请将该密钥设置在 ~/.openclaw/.env 中，或通过 env.shellEnv 设置，这样 Gateway 进程才能读取它。有关完整的优先级顺序，请参见 环境变量。
要通过 OpenRouter 路由 Perplexity 搜索，请设置 OPENROUTER_API_KEY （前缀为 sk-or-），而不是原生的 Perplexity 密钥。OpenClaw 会检测 该密钥并自动切换到 Sonar 传输。如果你已经配置了 OpenRouter 计费并希望在那边整合提供商，这会很有用。

​
相关内容

Perplexity 搜索工具

代理如何调用 Perplexity 搜索并解释结果。

配置参考

包含插件条目的完整配置参考。