本页内容
本页内容
工具
Perplexity 搜索
OpenClaw 支持 Perplexity Search API 作为 web_search 提供方。它会返回包含 title、url 和 snippet 字段的结构化结果。
为了兼容性,OpenClaw 还支持旧版 Perplexity Sonar/OpenRouter 设置。如果您使用 OPENROUTER_API_KEY、plugins.entries.perplexity.config.webSearch.apiKey 中的 sk-or-... 密钥,或设置 plugins.entries.perplexity.config.webSearch.baseUrl / model,则提供程序会切换到聊天完成路径并返回带有引文的 AI- 综合答案,而不是结构化搜索 API 结果。
安装插件
安装官方插件:
安装自动应用于正在运行的网关;否则下次启动时生效。请参阅 应用更改并检查 。
获取 Perplexity API 密钥
- 在perplexity.ai/settings/api.创建一个Perplexity帐户
- 在仪表板中生成 API 密钥。
- 将密钥存储在配置中,或在 Gateway 环境中设置
PERPLEXITY_API_KEY。
OpenRouter 兼容性
如果您已将 OpenRouter 用于 Perplexity 声纳,请保留 provider: "perplexity" 并在网关环境中设置 OPENROUTER_API_KEY,或在 plugins.entries.perplexity.config.webSearch.apiKey 中存储 sk-or-... 密钥。
可选的兼容性控制项:
plugins.entries.perplexity.config.webSearch.baseUrlplugins.entries.perplexity.config.webSearch.model
配置示例
原生 Perplexity 搜索 API
OpenRouter / Sonar 兼容性
在哪里设置密钥
通过配置: 运行 openclaw configure --section web。它会将密钥存储在 ~/.openclaw/openclaw.json 中的 plugins.entries.perplexity.config.webSearch.apiKey 下。该字段也接受 SecretRef 对象。
通过环境变量: 在 Gateway 进程环境中设置 PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY。对于 gateway 安装,请将其放入 ~/.openclaw/.env(或你的服务环境)中。参见 Env vars。
如果配置了 provider: "perplexity" 并且 Perplexity 密钥 SecretRef 未解析且没有 env 回退,则 startup/reload 会快速失败。
工具参数
这些参数适用于原生 Perplexity Search API 路径。
querystring必填搜索查询。
countnumberdefault: 5返回结果数量(1-10)。
countrystring2 个字母 ISO 国家/地区代码(e.g. US、DE)。
languagestringISO 639-1 语言代码(e.g. en、de、fr)。
freshness'day' | 'week' | 'month' | 'year'时间筛选 - day 表示 24 小时。
date_afterstring仅返回在此日期之后发布的结果(YYYY-MM-DD)。
date_beforestring仅返回在此日期之前发布的结果(YYYY-MM-DD)。
domain_filterstring[]域 allowlist/denylist 数组(最多 20 个)。
max_tokensnumberdefault: 25000总内容预算(最大 1000000)。
max_tokens_per_pagenumberdefault: 2048每页 token 限制。
对于旧版 Sonar/OpenRouter 兼容路径:
query、count和freshness可接受。count仅兼容;回复仍然是带有引文的综合答案,而不是 N- 结果列表。- Search API-仅过滤器(
country、language、date_after、date_before、domain_filter、max_tokens、max_tokens_per_page)返回显式错误。
示例:
域名过滤规则
- 每个过滤器最多 20 个域名。
- 不能在同一次请求中混合白名单和黑名单条目。
- 对拒绝列表条目使用
-前缀(e.g.、["-reddit.com"])。
说明
- Perplexity Search API 返回结构化的网页搜索结果(
title、url、snippet)。 - OpenRouter,或显式设置
plugins.entries.perplexity.config.webSearch.baseUrl/model,会将 Perplexity 切回 Sonar 聊天补全,以保证兼容性。 - Sonar/OpenRouter 兼容模式会返回一个带引用的综合答案,而不是结构化的结果行。
- 结果默认缓存 15 分钟(可通过
cacheTtlMinutes配置)。