概述
Perplexity 在 OpenClaw 中扮演的角色与其他提供商有所不同——它不是一个文本生成的「模型提供商」，而是一个网络搜索工具提供商。通过 Perplexity Sonar API，OpenClaw 的 AI 助手可以实时检索互联网内容，将搜索结果作为上下文注入对话，从而大幅提升回答时效性和事实准确度。
OpenClaw 支持两种接入方式：直接使用 Perplexity 原生 API（pplx- 前缀密钥），或通过 OpenRouter 路由（sk-or- 前缀密钥）。系统会根据 API Key 的前缀自动选择正确的路由方式。
快速开始
第一步：获取 Perplexity API Key
前往 perplexity.ai/settings/api 创建 API Key，密钥格式以 pplx- 开头。
第二步：配置搜索插件
方式一：使用交互式配置向导
openclaw configure --section web
方式二：直接命令行设置
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxxxxxxxxxx"
方式三：设置环境变量（推荐）
export PERPLEXITY_API_KEY="pplx-xxxxxxxxxxxxxxxxxxxx"
配置参数
{
env: {
PERPLEXITY_API_KEY: "pplx-xxxxxxxxxxxxxxxxxxxx"
},
plugins: {
entries: {
perplexity: {
config: {
webSearch: {
apiKey: "${PERPLEXITY_API_KEY}",
// 以下为可选过滤参数
country: "CN", // 搜索结果国家偏向（ISO 3166-1 两位代码）
language: "zh", // 结果语言（ISO 639-1 代码）
dateRange: "month", // 时间范围：day | week | month | year
domainAllowlist: [], // 仅从这些域名返回结果（最多 20 个）
domainDenylist: [], // 排除这些域名的结果（最多 20 个）
maxTokens: 2048 // 搜索结果内容预算
}
}
}
}
},
tools: {
web: {
search: {
provider: "perplexity"
}
}
}
}
支持的模型
Perplexity 在 OpenClaw 中作为搜索工具使用，底层调用 Sonar 系列搜索模型：
| 路由方式 | API Key 前缀 | 说明 |
|---|---|---|
| 原生 Perplexity API | pplx- |
直连 Perplexity，延迟低 |
| OpenRouter（Sonar） | sk-or- |
通过 OpenRouter 路由，可复用已有账户 |
OpenClaw 根据 API Key 前缀自动判断路由，无需手动切换配置。
典型使用场景
启用 Perplexity 后，在对话中可以询问实时信息：
openclaw chat --message "今天 OpenAI 有什么新公告？"
openclaw chat --message "最新的 Python 3.13 有哪些新特性？"
助手会先通过 Perplexity 检索相关内容，再综合搜索结果给出回答，同时附上信息来源链接。
注意事项
工具定位：Perplexity 是搜索工具而非生成模型，需要配合其他模型提供商（如 Anthropic、OpenAI）一起使用。搜索结果作为上下文输入到主模型，最终回答由主模型生成。
域名过滤：domainAllowlist 和 domainDenylist 各最多支持 20 个域名，适合需要限定信息来源的专业场景（如仅搜索官方文档或特定新闻站点）。
后台守护进程：以 launchd 或 systemd 方式部署时，PERPLEXITY_API_KEY 需写入 ~/.openclaw/.env，确保守护进程启动时能正确读取凭证。
费用控制：可通过 maxTokens 参数限制每次搜索返回的内容长度，避免因搜索结果过长而消耗过多主模型的 token 配额。