Perplexity

The Perplexity 插件注册了一个 web_search 提供商，具有两种传输方式：原生 Perplexity Search API（带过滤器的结构化结果）以及 Perplexity Sonar chat completions（直接或通过 OpenRouter，带引用的 AI 合成答案）。

Note

本页介绍 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

安装会自动应用到正在运行的 Gateway；否则将在下次启动时生效。请参阅应用更改并检查。

快速开始¶

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. 开始搜索

当 Perplexity 密钥成为可用的搜索凭据时，web_search 会自动检测 Perplexity；无需进一步设置。若要显式固定提供商：

openclaw config set tools.web.search.provider perplexity

搜索模式¶

插件按以下顺序解析传输方式：

设置了 webSearch.baseUrl 或 webSearch.model：始终通过 Sonar chat completions 路由到该端点，无论密钥类型如何。
否则，密钥来源决定端点：已配置密钥的前缀选择传输方式（配置优先于环境变量）；环境变量密钥直接使用其匹配端点。

密钥前缀	传输方式	功能
`pplx-`	原生 Perplexity Search API（`https://api.perplexity.ai`）	结构化结果、域名/语言/日期过滤
`sk-or-`	OpenRouter（`https://openrouter.ai/api/v1`），Sonar 模型	带引用的 AI 合成答案

具有任何其他前缀的已配置密钥也使用原生 Search API。chat-completions 路径默认使用 perplexity/sonar-pro 模型；可通过 plugins.entries.perplexity.config.webSearch.model 覆盖它。

原生 API 过滤¶

过滤器	描述	传输方式
`count`	每次搜索的结果数，1-10（默认 5）；在 chat-completions 路径上接受但忽略	两者
`freshness`	时间范围：`day`、`week`、`month`、`year`	两者
`country`	两位国家代码（`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`	所有结果的内容预算 / 每页预算；`max_tokens` 最大 1000000	仅原生

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

高级配置¶

守护进程的环境变量

Warning

仅在交互式 shell 中导出的密钥，除非显式导入该环境，否则对 launchd/systemd Gateway 守护进程不可见。请将密钥设置在 ~/.openclaw/.env 中或通过 env.shellEnv 设置，以便 Gateway 进程可以读取它。完整的优先级顺序请参阅环境变量。

OpenRouter 代理设置

要通过 OpenRouter 路由 Perplexity 搜索，请设置 OPENROUTER_API_KEY（前缀 sk-or-）而不是原生 Perplexity 密钥。OpenClaw 会检测该密钥并自动切换到 Sonar 传输方式。如果你已经配置了 OpenRouter 计费并希望在那里集中提供商，这很有用。

集成请求头

发往 Perplexity API（api.perplexity.ai）的请求会使用 X-Pplx-Integration: openclaw/<version> 标识 OpenClaw。通过 OpenRouter 路由的搜索会改为发送 OpenRouter 的应用归属请求头。自定义代理 baseUrl 两者都不会发送。

Perplexity 搜索工具

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

配置参考

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

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw