OpenClaw supports Perplexity Search API as a For compatibility, OpenClaw also supports legacy Perplexity Sonar\/OpenRouter setups. If you were already using OpenRouter for Perplexity Sonar, keep Optional compatibility controls:<\/p>\n “`json5 theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} Via config:<\/strong> run Via environment:<\/strong> set If These parameters apply to the native Perplexity Search API path.<\/p>\n For the legacy Sonar\/OpenRouter compatibility path, only Examples:<\/strong><\/p>\n “`javascript theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}} \/\/ Recent results (past week) \/\/ Date range search \/\/ Domain filtering (allowlist) \/\/ Domain filtering (denylist – prefix with -) \/\/ More content extraction See Web tools<\/a> for the full web_search configuration. Perplexity Search Perplexity Search API OpenClaw suppor […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-645","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/645","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=645"}],"version-history":[{"count":2,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/645\/revisions"}],"predecessor-version":[{"id":701,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/645\/revisions\/701"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=645"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=645"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=645"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}web_search<\/code> provider.
\nIt returns structured results with title<\/code>, url<\/code>, and snippet<\/code> fields.<\/p>\n
\nIf you use OPENROUTER_API_KEY<\/code>, an sk-or-...<\/code> key in plugins.entries.perplexity.config.webSearch.apiKey<\/code>, or set plugins.entries.perplexity.config.webSearch.baseUrl<\/code> \/ model<\/code>, the provider switches to the chat-completions path and returns AI-synthesized answers with citations instead of structured Search API results.<\/p>\nGetting a Perplexity API key<\/h2>\n
\n
PERPLEXITY_API_KEY<\/code> in the Gateway environment.<\/li>\n<\/ol>\nOpenRouter compatibility<\/h2>\n
provider: \"perplexity\"<\/code> and set OPENROUTER_API_KEY<\/code> in the Gateway environment, or store an sk-or-...<\/code> key in plugins.entries.perplexity.config.webSearch.apiKey<\/code>.<\/p>\n\n
plugins.entries.perplexity.config.webSearch.baseUrl<\/code><\/li>\nplugins.entries.perplexity.config.webSearch.model<\/code><\/li>\n<\/ul>\nConfig examples<\/h2>\n
Native Perplexity Search API<\/h3>\n
\n{
\n plugins: {
\n entries: {
\n perplexity: {
\n config: {
\n webSearch: {
\n apiKey: “pplx-…”,
\n },
\n },
\n },
\n },
\n },
\n tools: {
\n web: {
\n search: {
\n provider: “perplexity”,
\n },
\n },
\n },
\n}<\/p>\n\n### OpenRouter \/ Sonar compatibility\n\n```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}\n{\n plugins: {\n entries: {\n perplexity: {\n config: {\n webSearch: {\n apiKey: "<openrouter-api-key>",\n baseUrl: "https:\/\/openrouter.ai\/api\/v1",\n model: "perplexity\/sonar-pro",\n },\n },\n },\n },\n },\n tools: {\n web: {\n search: {\n provider: "perplexity",\n },\n },\n },\n}\n<\/code><\/pre>\nWhere to set the key<\/h2>\n
openclaw configure --section web<\/code>. It stores the key in
\n~\/.openclaw\/openclaw.json<\/code> under plugins.entries.perplexity.config.webSearch.apiKey<\/code>.
\nThat field also accepts SecretRef objects.<\/p>\nPERPLEXITY_API_KEY<\/code> or OPENROUTER_API_KEY<\/code>
\nin the Gateway process environment. For a gateway install, put it in
\n~\/.openclaw\/.env<\/code> (or your service environment). See Env vars<\/a>.<\/p>\nprovider: \"perplexity\"<\/code> is configured and the Perplexity key SecretRef is unresolved with no env fallback, startup\/reload fails fast.<\/p>\nTool parameters<\/h2>\n
\n\n
\n \nParameter<\/th>\n Description<\/th>\n<\/tr>\n<\/thead>\n \n query<\/code><\/td>\nSearch query (required)<\/td>\n<\/tr>\n \n count<\/code><\/td>\nNumber of results to return (1-10, default: 5)<\/td>\n<\/tr>\n \n country<\/code><\/td>\n2-letter ISO country code (e.g., “US”, “DE”)<\/td>\n<\/tr>\n \n language<\/code><\/td>\nISO 639-1 language code (e.g., “en”, “de”, “fr”)<\/td>\n<\/tr>\n \n freshness<\/code><\/td>\nTime filter: day<\/code> (24h), week<\/code>, month<\/code>, or year<\/code><\/td>\n<\/tr>\n\n date_after<\/code><\/td>\nOnly results published after this date (YYYY-MM-DD)<\/td>\n<\/tr>\n \n date_before<\/code><\/td>\nOnly results published before this date (YYYY-MM-DD)<\/td>\n<\/tr>\n \n domain_filter<\/code><\/td>\nDomain allowlist\/denylist array (max 20)<\/td>\n<\/tr>\n \n max_tokens<\/code><\/td>\nTotal content budget (default: 25000, max: 1000000)<\/td>\n<\/tr>\n \n max_tokens_per_page<\/code><\/td>\nPer-page token limit (default: 2048)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n query<\/code> and freshness<\/code> are supported.
\nSearch API-only filters such as country<\/code>, language<\/code>, date_after<\/code>, date_before<\/code>, domain_filter<\/code>, max_tokens<\/code>, and max_tokens_per_page<\/code> return explicit errors.<\/p>\n
\n\/\/ Country and language-specific search
\nawait web_search({
\n query: “renewable energy”,
\n country: “DE”,
\n language: “de”,
\n});<\/p>\n
\nawait web_search({
\n query: “AI news”,
\n freshness: “week”,
\n});<\/p>\n
\nawait web_search({
\n query: “AI developments”,
\n date_after: “2024-01-01”,
\n date_before: “2024-06-30”,
\n});<\/p>\n
\nawait web_search({
\n query: “climate research”,
\n domain_filter: [“nature.com”, “science.org”, “.edu”],
\n});<\/p>\n
\nawait web_search({
\n query: “product reviews”,
\n domain_filter: [“-reddit.com”, “-pinterest.com”],
\n});<\/p>\n
\nawait web_search({
\n query: “detailed AI research”,
\n max_tokens: 50000,
\n max_tokens_per_page: 4096,
\n});
\n“`<\/p>\nDomain filter rules<\/h3>\n
\n
-<\/code> prefix for denylist entries (e.g., [\"-reddit.com\"]<\/code>)<\/li>\n<\/ul>\nNotes<\/h2>\n
\n
title<\/code>, url<\/code>, snippet<\/code>)<\/li>\nplugins.entries.perplexity.config.webSearch.baseUrl<\/code> \/ model<\/code> switches Perplexity back to Sonar chat completions for compatibility<\/li>\ncacheTtlMinutes<\/code>)<\/li>\n<\/ul>\n
\nSee Perplexity Search API docs<\/a> for more details.<\/p>\n","protected":false},"excerpt":{"rendered":"