Skip to main content
Perplexity 插件注册了一个 web_search 提供商，包含两种传输方式： 原生 Perplexity Search API（带筛选器的结构化结果）和 Perplexity Sonar 聊天补全，可直接使用或通过 OpenRouter 使用（带引文的 AI 合成答案）。
本页介绍 Perplexity 提供商设置。有关 Perplexity 工具（智能体如何使用它），请参阅 Perplexity 搜索。
属性值
类型Web 搜索提供商（不是模型提供商）
凭证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"
在 Gateway 网关环境中导出为 PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY 的密钥也可以使用。
2

开始搜索

web_search 会在 Perplexity 密钥成为可用搜索凭证后自动检测 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两者
country2 字母国家/地区代码（us、de、jp）仅原生
languageISO 639-1 语言代码（en、fr、zh）仅原生
date_after / date_beforeYYYY-MM-DD 格式的发布日期范围仅原生
domain_filter最多 20 个域名；允许列表或以 - 为前缀的拒绝列表，不能混用仅原生
max_tokens / max_tokens_per_page所有结果的内容预算 / 每页内容预算仅原生
仅原生支持的筛选器在聊天补全路径上会返回描述性错误。 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 搜索并解释结果。

配置参考

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