OpenClaw Perplexity 提供商配置指南
Perplexity 插件通过 Perplexity Search API 或 OpenRouter 上的 Perplexity Sonar 提供网页搜索能力。
本页面介绍 Perplexity 提供商 的配置方法。如需了解 Perplexity 工具（代理如何使用它），请查看 Perplexity tool 文档。
- 类型：网页搜索提供商（非模型提供商）
- 鉴权方式：
PERPLEXITY_API_KEY（直连）或OPENROUTER_API_KEY（通过 OpenRouter） - 配置路径：
plugins.entries.perplexity.config.webSearch.apiKey
快速开始
- 设置 API 密钥：
## 交互式配置
openclaw configure --section web或者直接设置：
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"- 配置完成后，代理会自动使用 Perplexity 进行网页搜索。
搜索模式
插件会根据 API 密钥的前缀自动选择传输方式：
| 密钥前缀 | 传输方式 | 功能 |
|---|---|---|
pplx- |
原生 Perplexity Search API | 结构化结果，支持域名 / 语言 / 日期过滤 |
sk-or- |
OpenRouter（Sonar） | 带引用的 AI 合成回答 |
原生 API 过滤功能
当使用原生 Perplexity API（pplx- 开头的密钥）时，搜索支持以下过滤功能：
- 国家：2 字母国家代码
- 语言：ISO 639-1 语言代码
- 日期范围：day、week、month、year
- 域名过滤：允许 / 拒绝列表（最多 20 个域名）
- 内容预算：
max_tokens、max_tokens_per_page
环境说明
如果网关以守护进程（launchd/systemd）的方式运行，请确保 PERPLEXITY_API_KEY 对该进程可见（例如，放在 ~/.openclaw/.env 中，或是通过 env.shellEnv 配置）。