Perplexity（Web 搜索提供商）
Perplexity 插件通过 Perplexity Search API 或通过 OpenRouter 使用的 Perplexity Sonar 提供 Web 搜索能力。本页介绍 Perplexity 提供商 设置。关于 Perplexity
工具（智能体如何使用它），请参阅 Perplexity 工具。
- 类型：Web 搜索提供商（不是模型提供商）
- 鉴权：
PERPLEXITY_API_KEY（直连）或OPENROUTER_API_KEY（通过 OpenRouter） - 配置路径：
plugins.entries.perplexity.config.webSearch.apiKey
快速开始
- 设置 API 密钥：
- 配置完成后，智能体会自动使用 Perplexity 执行 Web 搜索。
搜索模式
该插件会根据 API 密钥前缀自动选择传输方式：| 密钥前缀 | 传输方式 | 功能 |
|---|---|---|
pplx- | 原生 Perplexity Search API | 结构化结果、域名/语言/日期过滤 |
sk-or- | OpenRouter（Sonar） | 带引用的 AI 合成答案 |
原生 API 过滤
使用原生 Perplexity API（pplx- 密钥）时，搜索支持：
- 国家：2 位国家代码
- 语言：ISO 639-1 语言代码
- 日期范围：天、周、月、年
- 域名过滤：允许列表/拒绝列表（最多 20 个域名）
- 内容预算：
max_tokens、max_tokens_per_page
环境说明
如果 Gateway 网关以守护进程（launchd/systemd）方式运行，请确保PERPLEXITY_API_KEY 可供该进程使用（例如在
~/.openclaw/.env 中，或通过 env.shellEnv）。