Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Perplexity 插件通过 Perplexity Search API 或经由 OpenRouter 的 Perplexity Sonar 提供 Web 搜索能力。
本页介绍的是 Perplexity 提供商设置。关于 Perplexity 工具（即智能体如何使用它），请参见 Perplexity tool。
属性值
类型Web 搜索提供商（不是模型提供商）
认证PERPLEXITY_API_KEY（直连）或 OPENROUTER_API_KEY（通过 OpenRouter）
配置路径plugins.entries.perplexity.config.webSearch.apiKey

​
入门指南

1

设置 API key

运行交互式 Web 搜索配置流程：
openclaw configure --section web
或直接设置密钥：
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

开始搜索

一旦配置好密钥，智能体会自动使用 Perplexity 进行 Web 搜索。 无需额外步骤。

​
搜索模式

插件会根据 API key 前缀自动选择传输方式：
当你的密钥以 pplx- 开头时，OpenClaw 会使用原生 Perplexity Search API。此传输方式会返回结构化结果，并支持域名、语言和日期过滤（见下方过滤选项）。
密钥前缀传输方式功能
pplx-原生 Perplexity Search API结构化结果、域名/语言/日期过滤
sk-or-OpenRouter（Sonar）带引用的 AI 综合答案

​
原生 API 过滤

过滤选项仅在使用原生 Perplexity API （pplx- 密钥）时可用。OpenRouter/Sonar 搜索不支持这些参数。
使用原生 Perplexity API 时，搜索支持以下过滤器：
过滤器说明示例
国家两位国家代码us、de、jp
语言ISO 639-1 语言代码en、fr、zh
日期范围最近时间窗口day、week、month、year
域名过滤allowlist 或 denylist（最多 20 个域名）example.com
内容预算每次响应 / 每页的 token 上限max_tokens、max_tokens_per_page

​
高级配置

如果 OpenClaw Gateway 网关 作为守护进程运行（launchd/systemd），请确保 PERPLEXITY_API_KEY 对该进程可见。
如果某个密钥只设置在 ~/.profile 中，那么除非显式导入该环境，否则 launchd/systemd 守护进程将无法看到它。请在 ~/.openclaw/.env 或通过 env.shellEnv 设置该密钥， 以确保 gateway 进程可以读取它。
如果你更希望通过 OpenRouter 路由 Perplexity 搜索，请设置 OPENROUTER_API_KEY（前缀为 sk-or-），而不是原生 Perplexity 密钥。 OpenClaw 会检测此前缀，并自动切换到 Sonar 传输方式。
如果你已经有 OpenRouter 账户，并希望跨多个提供商统一计费， 那么 OpenRouter 传输方式会很有用。

​
相关

Perplexity 搜索工具

智能体如何调用 Perplexity 搜索并解释结果。

配置参考

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