Perplexity 插件为 OpenClaw 提供网络搜索能力，支持原生 Perplexity Search API 和通过 OpenRouter 的 Sonar 路由。
注意：这是 Perplexity provider 配置页，agent 如何使用搜索工具见 Perplexity tool 文档。
| 属性 | 值 |
|---|---|
| 类型 | 网络搜索 provider（非模型 provider） |
| 认证 | PERPLEXITY_API_KEY（直连）或 OPENROUTER_API_KEY（通过 OpenRouter） |
| 配置路径 | plugins.entries.perplexity.config.webSearch.apiKey |
快速开始
openclaw configure --section web
# 或直接设置
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"搜索模式
插件根据 API key 前缀自动选择传输方式：
| Key 前缀 | 传输方式 | 特性 |
|---|---|---|
pplx- | 原生 Perplexity Search API | 结构化结果，支持域名/语言/日期过滤 |
sk-or- | OpenRouter（Sonar） | AI 合成答案 + 引用 |
原生 API 过滤选项
仅 pplx- key 支持以下过滤：
| 过滤器 | 说明 | 示例 |
|---|---|---|
| 国家 | 2 字母国家代码 | us、de、jp |
| 语言 | ISO 639-1 | en、fr、zh |
| 日期范围 | 时间窗口 | day、week、month、year |
| 域名过滤 | 白名单或黑名单（最多 20 个） | example.com |
| 内容预算 | token 限制 | max_tokens、max_tokens_per_page |
注意事项
daemon 进程（launchd/systemd）需确保 PERPLEXITY_API_KEY 对该进程可见，建议写入 ~/.openclaw/.env 或通过 env.shellEnv 配置。
相关链接
- provider-xai — xAI 也提供 web_search 和 x_search 工具
- providers — 所有 provider 总览