原生 Search API
像外勤把一张整齐的小报告交给你：标题、网址、摘要，规规矩矩三列。
Tools 导读
Perplexity 搜索接入：两种模式，一个入口
OpenClaw 支持两种 Perplexity 搜索方式：原生 Search API（返回结构化结果）和 OpenRouter/Sonar 兼容模式（返回 AI 合成答案）。配置时最容易混淆的是 apiKey 的格式——原生用 pplx- 开头，OpenRouter 用 sk-or- 开头，填错会导致模式切换。建议先确认你用的是哪种 API 密钥，再按对应配置块填写。
先讲这一页到底在解决什么
Perplexity 搜索接入：两种模式，一个入口
OpenClaw 支持两种 Perplexity 搜索方式：原生 Search API（返回结构化结果）和 OpenRouter/Sonar 兼容模式（返回 AI 合成答案）。配置时最容易混淆的是 apiKey 的格式——原生用 pplx- 开头，OpenRouter 用 sk-or- 开头，填错会导致模式切换。建议先确认你用的是哪种 API 密钥，再按对应配置块填写。
第一站
🪞 它为什么像有两张脸
官方开头讲 compatibility，看起来像历史包袱，其实是非常实用的提醒：同样写着 provider: "perplexity"，返回的东西可能长得完全不一样。
Sonar / OpenRouter 兼容路
像它不只给你线索，还先把这些线索嚼了一遍，直接带回一段带引用的回答。
为什么要先分清
因为后面很多参数只对原生搜索 API 有效。你走兼容路时，再扔这些参数过去，系统会明确报错。
一句话先记住
Perplexity 可以是“带回资料单”，也可以是“先帮你总结一嘴”。
第二站
🔑 拿 key 和配置这段，翻成人话就是“给这位搜索员发哪张工牌”
这部分主线很简单：你要么给它 Perplexity 自家的工牌，要么继续走以前 OpenRouter 那条兼容老路。
PERPLEXITY_API_KEY像给它发 Perplexity 自家的正式工牌。这样它更像按“原生搜索员”上岗。
OPENROUTER_API_KEY像告诉系统：“我们继续走以前那条兼容老路。”这时它更像 Sonar 聊天答案模式，而不是纯结构化搜索。
baseUrl / model这些字段像额外路标。只要你显式填了，系统就知道你不是在走最朴素的原生路子。
openclaw configure --section web像把“你想叫哪位搜索员出门、他拿哪张工牌”一次填进系统。
第三站
🎛 参数表其实都在讲“你要它搜得多细、带回多少料、排除哪几家”
别被参数名吓到。翻成人话以后，大多数都很顺。
count像说：“先带 5 条线索回来，不用把整条街都翻遍。”
country / language像交代这次先去哪个国家、哪种语言圈打听消息。
freshness / date_after / date_before像补一句：“我只要最近的，或者只要某个时间窗里的线索。”
max_tokens / max_tokens_per_page像规定这次最多带多少内容回来，以及每一页最多抄多少，别一页就把背包塞爆。
第四站
🚧 domain_filter 像给搜索员一份“可以去哪些街区、不要去哪些街区”的名单
这个功能很实用，因为很多时候你不是没答案，而是答案被不想看的站点淹掉了。
✅ allowlist
像明确说：“这次只去 nature、science、.edu 这些街区打听。”
🚫 denylist
像说：“别去 reddit、pinterest 那几条街转了，太吵。”
❌ 不能混着写
因为这张名单要么是“只许去哪”，要么是“这些地方别去”，两种规矩不能一口气都贴给它。
📌 最大 20 个域名
像给搜索员的黑白名单不能无限长，不然它还没出门先被规则淹死了。
第五站
🪵 为什么兼容路有时会报“这个参数不支持”
因为你一旦走的是 OpenRouter / Sonar 兼容路径，它干的已经不再是同一种搜索工作。
📚 原生 Search API
像一个老老实实带结果清单回来的搜索员，所以国家、语言、日期、域名这些过滤器都能挂上去。
🗣 Sonar / OpenRouter
像另一个更爱先总结再回答的人。它能懂的旋钮少得多，主要只认 query 和 freshness 这种基础口令。
🎈 这节一句话
不是参数坏了，而是你换了一条路，车就不是同一辆了。
🔐 fail fast 那句在讲什么
像你明明指定了要叫 Perplexity 出门，结果它的工牌没解出来。系统会选择立刻提醒你，而不是等半路才掉链子。
第六站
🧪 官方例子真正想教你的，不是语法，而是“怎么提更像一张靠谱搜索任务单”
这些例子凑在一起看，主线很清楚：你可以按地区搜、按时间搜、按站点搜、按内容量搜。
国家 / 语言搜索
像你明确指定“去德国那边打听，用德语结果”。
最近一周
像告诉它：“别翻旧报纸了，只要最近这周的消息。”
日期区间
像把资料窗口框得更窄，避免它把太旧或太新的都混进来。
更高 token 预算
像允许它多背一点资料回来，但这也意味着包更重、回得可能更慢。
最后总结
🎈 把 Perplexity Search 这页压成一句话
Perplexity Search 像一个会找资料的搜索员，但它既可以老老实实交结构化结果单，也可能顺手先帮你总结一嘴；读这页时，最先分清你走的是原生 Search API 还是兼容老路。
如果你下一页只想继续看一页，我建议接着看 /tools/web 或 /tools/tavily。这样你会更容易比较：同样是网页搜索，Perplexity、Tavily、Brave 到底各擅长哪种打法。