How should perplexity-web-search be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Claim this agent

Agent DossierCLAWHUBSafety 84/100

Xpersona Agent

perplexity-web-search

Web Search Skill --- name: web_search description: Web search and URL fetching via Perplexity (default: sonar, optional: sonar-pro). Use when searching the web, looking up information, fetching URL content, or configuring web search settings. Covers web_search tool (Perplexity direct API) and web_fetch tool (HTML to markdown extraction). homepage: https://github.com/aligurelli/clawd/tree/main/skills/web_search metadata: {"clawdbot":{

OpenClaw · self-declared

Trust evidence available

View on ClawHub

clawhub skill install skills:aligurelli:perplexity-web-search

Overall rank

#62

Adoption

No public adoption signal

Trust

Unknown

Freshness

Feb 25, 2026

Freshness

Last checked Feb 25, 2026

Best For

perplexity-web-search is best for general automation workflows where OpenClaw compatibility matters.

Not Ideal For

Contract metadata is missing or unavailable for deterministic execution.

Evidence Sources Checked

editorial-content, CLAWHUB, runtime-metrics, public facts pack

Overview Evidence & Timeline Artifacts & Docs API & Reliability Media & Related Machine Appendix

Overview

Key links, install path, reliability highlights, and the shortest practical read before diving into the crawl record.

Verifiededitorial-content

Overview

Executive Summary

No verified compatibility signals

Trust score

Unknown

Compatibility

OpenClaw

Freshness

Feb 25, 2026

Vendor

Openclaw

Artifacts

Benchmarks

Last release

Unpublished

Install & run

Setup Snapshot

clawhub skill install skills:aligurelli:perplexity-web-search

1
Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence & Timeline

Public facts grouped by evidence type, plus release and crawl events with provenance and freshness.

Verifiededitorial-content

Public facts

Evidence Ledger

Vendor (1)

Vendor

Openclaw

profilemedium

Observed Apr 15, 2026Source link Provenance

Compatibility (1)

Protocol compatibility

OpenClaw

contractmedium

Observed Apr 15, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium

Observed Apr 15, 2026Source link Provenance

Events

Release & Crawl Timeline

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts & Docs

Parameters, dependencies, examples, extracted files, editorial overview, and the complete README when available.

Self-declaredCLAWHUB

Captured outputs

Artifacts Archive

Extracted files

Examples

Snippets

Languages

typescript

Parameters

Executable Examples

json5

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "<your-perplexity-api-key>",
          baseUrl: "https://api.perplexity.ai",
          model: "sonar"
        }
      }
    }
  }
}

json5

{
  tools: {
    web: {
      search: {
        perplexity: {
          model: "sonar-pro"
        }
      }
    }
  }
}

text

web_search(query="cell tower finder app complaints features users want reddit twitter quora")

text

web_search(query="site:reddit.com best stud finder app")

text

web_search(query="latest Flutter updates", freshness="pw")
web_search(query="İstanbul hava durumu", country="TR", search_lang="tr")
web_search(query="AI news", count=5, freshness="pd")
web_search(query="GLP-1 tracker app wish features complaints reddit twitter quora")

Editorial read

Docs & README

Docs source

CLAWHUB

Editorial quality

ready

Full README

name: web_search description: Web search and URL fetching via Perplexity (default: sonar, optional: sonar-pro). Use when searching the web, looking up information, fetching URL content, or configuring web search settings. Covers web_search tool (Perplexity direct API) and web_fetch tool (HTML to markdown extraction). homepage: https://github.com/aligurelli/clawd/tree/main/skills/web_search metadata: {"clawdbot":{"emoji":"🔎"}}

Web Search Skill

Web search via Perplexity (default: sonar) and URL content fetching. Sonar-pro is optional for deeper analysis.

Credentials

This skill uses the Perplexity key configured in your OpenClaw setup. No shared or third-party keys are used.

If your environment is not already configured, set PERPLEXITY_API_KEY or configure the key in OpenClaw config.

Recommended default (cost-effective):

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "<your-perplexity-api-key>",
          baseUrl: "https://api.perplexity.ai",
          model: "sonar"
        }
      }
    }
  }
}

Optional deep mode (higher quality, higher cost):

{
  tools: {
    web: {
      search: {
        perplexity: {
          model: "sonar-pro"
        }
      }
    }
  }
}

Use sonar-pro only when you explicitly need deeper analysis.

Get your API key at: https://www.perplexity.ai/settings/api

Data Handling

All search queries are sent to Perplexity's API (https://api.perplexity.ai)
web_fetch fetched page contents are processed locally by OpenClaw (not sent to Perplexity)
This instruction-only skill does not persist data by itself; query handling/retention is governed by OpenClaw + Perplexity policies
Search queries are sent to Perplexity; do not include secrets or private data in queries
Your own Perplexity API key and account terms apply

web_search

Search the web. Returns AI-synthesized answers with citations.

Parameters:

query (required) — search query
count (1-10) — number of results
country — 2-letter code: TR, US, DE, ALL
search_lang — result language: tr, en, de, fr
freshness — time filter: pd (day), pw (week), pm (month), py (year)

Including Social Platform Results

For market research or user feedback queries, add social platform names naturally to the query. This makes Perplexity include results from Reddit, Twitter, Quora etc. alongside normal web results — no filtering, no restriction, just broader coverage.

web_search(query="cell tower finder app complaints features users want reddit twitter quora")

Perplexity will pull from both regular websites AND social platforms in one search.

For cases where you ONLY want a specific platform, use site: operator:

web_search(query="site:reddit.com best stud finder app")

Examples:

web_search(query="latest Flutter updates", freshness="pw")
web_search(query="İstanbul hava durumu", country="TR", search_lang="tr")
web_search(query="AI news", count=5, freshness="pd")
web_search(query="GLP-1 tracker app wish features complaints reddit twitter quora")

web_fetch

Fetch URL content as markdown/text. No JS execution. Content is extracted locally.

Parameters:

url (required) — HTTP/HTTPS URL
extractMode — markdown (default) or text
maxChars — truncation limit

Perplexity Models (User Choice)

sonar (default) — fast Q&A + web search, cost-effective
sonar-pro — multi-step reasoning + web search (use when deeper analysis is needed)
sonar-reasoning-pro — deep chain-of-thought research (expensive, use sparingly)

Set the model in config based on your budget/quality preference.

API & Reliability

Machine endpoints, contract coverage, trust signals, runtime metrics, benchmarks, and guardrails for agent-to-agent use.

MissingCLAWHUB

Machine interfaces

Contract & API

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

missing

Auth

None

Streaming

Data region

Unspecified

Protocol support

OpenClaw: self-declared

Requires: none

Forbidden: none

Guardrails

Operational confidence: low

No positive guardrails captured.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/snapshot"

curl -s "https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/contract"

curl -s "https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/trust"

Operational fit

Reliability & Benchmarks

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

Do not use if

Contract metadata is missing or unavailable for deterministic execution.

No benchmark suites or observed failure patterns are available.

Machine Appendix

Raw contract, invocation, trust, capability, facts, and change-event payloads for machine-side inspection.

MissingCLAWHUB

Contract JSON

{
  "contractStatus": "missing",
  "authModes": [],
  "requires": [],
  "forbidden": [],
  "supportsMcp": false,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": null,
  "outputSchemaRef": null,
  "dataRegion": null,
  "contractUpdatedAt": null,
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "OPENCLEW"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "CLAWHUB",
      "generatedAt": "2026-04-17T05:27:57.487Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "OPENCLEW",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    }
  ],
  "flattenedTokens": "protocol:OPENCLEW|unknown|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Openclaw",
    "href": "https://github.com/openclaw/skills/tree/main/skills/aligurelli/perplexity-web-search",
    "sourceUrl": "https://github.com/openclaw/skills/tree/main/skills/aligurelli/perplexity-web-search",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-04-15T00:45:39.800Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "OpenClaw",
    "href": "https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/contract",
    "sourceType": "contract",
    "confidence": "medium",
    "observedAt": "2026-04-15T00:45:39.800Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/clawhub-skills-aligurelli-perplexity-web-search/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]

Overview

Executive Summary

Setup Snapshot

Evidence & Timeline

Evidence Ledger

Release & Crawl Timeline

Artifacts & Docs

Artifacts Archive

Docs & README

Web Search Skill

Credentials

Data Handling

web_search

Including Social Platform Results

web_fetch

Perplexity Models (User Choice)

API & Reliability

Contract & API

Reliability & Benchmarks

Media & Related

Media & Demo

Related Agents

Machine Appendix