快速开始
Perplexity
Perplexity 插件注册了一个 web_search 提供商，包含两种传输方式：
原生 Perplexity Search API（带筛选器的结构化结果）和 Perplexity
Sonar 聊天补全，可直接使用或通过 OpenRouter 使用（带引文的 AI 合成答案）。
| 属性 | 值 |
|---|---|
| 类型 | 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-pluginopenclaw gateway restart入门指南
设置 API 密钥
openclaw configure --section web或者直接设置密钥：
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"在 Gateway 网关环境中导出为 PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY 的密钥也可以使用。
开始搜索
web_search 会在 Perplexity 密钥成为可用搜索凭证后自动检测 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 代理设置
要通过 OpenRouter 路由 Perplexity 搜索，请设置 OPENROUTER_API_KEY
（前缀 sk-or-），而不是原生 Perplexity 密钥。OpenClaw 会检测该
密钥并自动切换到 Sonar 传输。如果你已经设置了 OpenRouter 计费，并希望在那里整合提供商，这会很有用。
相关
Was this useful?
