메인 콘텐츠로 건너뛰기
Perplexity Plugin은 Perplexity Search API 또는 OpenRouter를 통한 Perplexity Sonar로 웹 검색 기능을 제공합니다.
이 페이지는 Perplexity 제공자 설정입니다. Perplexity 도구(에이전트가 사용하는 방식)는 Perplexity 도구를 참조하세요.
속성값
유형웹 검색 제공자(모델 제공자가 아님)
인증PERPLEXITY_API_KEY(직접) 또는 OPENROUTER_API_KEY(OpenRouter 경유)
구성 경로plugins.entries.perplexity.config.webSearch.apiKey

​
Plugin 설치

공식 Plugin을 설치한 다음 Gateway를 다시 시작하세요. 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​
시작하기

1

API 키 설정

대화형 웹 검색 구성 흐름을 실행합니다.
openclaw configure --section web
또는 키를 직접 설정합니다.
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

검색 시작

키가 구성되면 에이전트가 웹 검색에 Perplexity를 자동으로 사용합니다. 추가 단계는 필요하지 않습니다.

​
검색 모드

Plugin은 API 키 접두사를 기준으로 전송 방식을 자동 선택합니다.
키가 pplx-로 시작하면 OpenClaw는 네이티브 Perplexity Search API를 사용합니다. 이 전송 방식은 구조화된 결과를 반환하고 도메인, 언어, 날짜 필터를 지원합니다(아래 필터링 옵션 참조).
키 접두사전송 방식기능
pplx-네이티브 Perplexity Search API구조화된 결과, 도메인/언어/날짜 필터
sk-or-OpenRouter (Sonar)인용이 포함된 AI 합성 답변

​
네이티브 API 필터링

필터링 옵션은 네이티브 Perplexity API(pplx- 키)를 사용할 때만 사용할 수 있습니다. OpenRouter/Sonar 검색은 이러한 매개변수를 지원하지 않습니다.
네이티브 Perplexity API를 사용할 때 검색은 다음 필터를 지원합니다.
필터설명예시
국가2글자 국가 코드us, de, jp
언어ISO 639-1 언어 코드en, fr, zh
날짜 범위최신성 기간day, week, month, year
도메인 필터허용 목록 또는 차단 목록(최대 20개 도메인)example.com
콘텐츠 예산응답당 / 페이지당 토큰 제한max_tokens, max_tokens_per_page

​
고급 구성

OpenClaw Gateway가 데몬(launchd/systemd)으로 실행되는 경우 PERPLEXITY_API_KEY를 해당 프로세스에서 사용할 수 있는지 확인하세요.
대화형 셸에서만 내보낸 키는 해당 환경을 명시적으로 가져오지 않는 한 launchd/systemd 데몬에 표시되지 않습니다. Gateway 프로세스가 키를 읽을 수 있도록 ~/.openclaw/.env 또는 env.shellEnv를 통해 키를 설정하세요.
OpenRouter를 통해 Perplexity 검색을 라우팅하려면 네이티브 Perplexity 키 대신 OPENROUTER_API_KEY(접두사 sk-or-)를 설정하세요. OpenClaw는 접두사를 감지하고 Sonar 전송 방식으로 자동 전환합니다.
OpenRouter 전송 방식은 이미 OpenRouter 계정이 있고 여러 제공자에 걸친 청구를 통합하려는 경우에 유용합니다.

​
관련 항목

Perplexity 검색 도구

에이전트가 Perplexity 검색을 호출하고 결과를 해석하는 방식입니다.

구성 참조

Plugin 항목을 포함한 전체 구성 참조입니다.