Skip to main content
Perplexity Plugin은 두 가지 전송 방식을 사용하는 web_search 공급자를 등록합니다. 하나는 필터가 포함된 구조화된 결과를 제공하는 네이티브 Perplexity Search API이고, 다른 하나는 직접 또는 OpenRouter를 통해 인용이 포함된 AI 합성 답변을 제공하는 Perplexity Sonar 채팅 완성입니다.
이 페이지에서는 Perplexity 공급자 설정을 다룹니다. Perplexity 도구(에이전트가 이를 사용하는 방법)에 대해서는 Perplexity 검색을 참조하세요.

​
Plugin 설치

​
시작하기

1

API 키 설정

또는 키를 직접 설정합니다.
Gateway 환경에서 PERPLEXITY_API_KEY 또는 OPENROUTER_API_KEY로 내보낸 키도 사용할 수 있습니다.
2

검색 시작

web_search는 Perplexity 키가 사용 가능한 검색 자격 증명이 되면 Perplexity를 자동으로 감지하므로 추가 설정이 필요하지 않습니다. 공급자를 명시적으로 고정하려면 다음을 실행합니다.

​
검색 모드

Plugin은 다음 순서로 전송 방식을 결정합니다.
  1. webSearch.baseUrl 또는 webSearch.model이 설정된 경우: 키 유형과 관계없이 항상 해당 엔드포인트에 대한 Sonar 채팅 완성을 통해 라우팅합니다.
  2. 그렇지 않으면 키 소스가 엔드포인트를 결정합니다. 구성된 키는 접두사에 따라 전송 방식을 선택하며(구성이 환경 변수보다 우선함), 환경 키는 일치하는 엔드포인트를 직접 사용합니다.
다른 접두사를 사용하는 구성된 키도 네이티브 Search API를 사용합니다. 채팅 완성 경로는 기본적으로 perplexity/sonar-pro 모델을 사용하며, plugins.entries.perplexity.config.webSearch.model로 재정의할 수 있습니다.

​
네이티브 API 필터링

네이티브 전용 필터를 채팅 완성 경로에서 사용하면 설명이 포함된 오류가 반환됩니다. freshness는 date_after/date_before와 함께 사용할 수 없습니다.

​
고급 구성

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

​
관련 항목

Perplexity 검색 도구

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

구성 참조

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