Providers
Perplexity
Perplexity Plugin은 두 가지 전송 방식을 사용하는 web_search 공급자를 등록합니다. 하나는 필터가 포함된 구조화된 결과를 제공하는 네이티브 Perplexity Search API이고, 다른 하나는 직접 또는 OpenRouter를 통해 인용이 포함된 AI 합성 답변을 제공하는 Perplexity Sonar 채팅 완성입니다.
| 속성 | 값 |
|---|---|
| 유형 | 웹 검색 공급자(모델 공급자가 아님) |
| 인증 | PERPLEXITY_API_KEY(네이티브) 또는 OPENROUTER_API_KEY(OpenRouter 경유) |
| 구성 경로 | plugins.entries.perplexity.config.webSearch.apiKey |
| 재정의 | plugins.entries.perplexity.config.webSearch.baseUrl / .model |
| 키 발급 | perplexity.ai/settings/api |
Plugin 설치
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart시작하기
API 키 설정
openclaw configure --section web또는 키를 직접 설정합니다.
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"Gateway 환경에서 PERPLEXITY_API_KEY 또는 OPENROUTER_API_KEY로 내보낸 키도 사용할 수 있습니다.
검색 시작
web_search는 Perplexity 키가 사용 가능한 검색 자격 증명이 되면 Perplexity를 자동으로 감지하므로 추가 설정이 필요하지 않습니다. 공급자를 명시적으로 고정하려면 다음을 실행합니다.
openclaw config set tools.web.search.provider perplexity검색 모드
Plugin은 다음 순서로 전송 방식을 결정합니다.
webSearch.baseUrl또는webSearch.model이 설정된 경우: 키 유형과 관계없이 항상 해당 엔드포인트에 대한 Sonar 채팅 완성을 통해 라우팅합니다.- 그렇지 않으면 키 소스가 엔드포인트를 결정합니다. 구성된 키는 접두사에 따라 전송 방식을 선택하며(구성이 환경 변수보다 우선함), 환경 키는 일치하는 엔드포인트를 직접 사용합니다.
| 키 접두사 | 전송 방식 | 기능 |
|---|---|---|
pplx- |
네이티브 Perplexity Search API (https://api.perplexity.ai) |
구조화된 결과, 도메인/언어/날짜 필터 |
sk-or- |
OpenRouter (https://openrouter.ai/api/v1), Sonar 모델 |
인용이 포함된 AI 합성 답변 |
다른 접두사를 사용하는 구성된 키도 네이티브 Search API를 사용합니다. 채팅 완성 경로는 기본적으로 perplexity/sonar-pro 모델을 사용하며, plugins.entries.perplexity.config.webSearch.model로 재정의할 수 있습니다.
네이티브 API 필터링
| 필터 | 설명 | 전송 방식 |
|---|---|---|
count |
검색당 결과 수, 1~10(기본값 5) | 네이티브 전용 |
freshness |
최신성 범위: day, week, month, year |
모두 |
country |
2자리 국가 코드(us, de, jp) |
네이티브 전용 |
language |
ISO 639-1 언어 코드(en, fr, zh) |
네이티브 전용 |
date_after / date_before |
YYYY-MM-DD 형식의 게시 날짜 범위 |
네이티브 전용 |
domain_filter |
최대 20개 도메인, 허용 목록 또는 - 접두사 차단 목록이며 혼용 불가 |
네이티브 전용 |
max_tokens / max_tokens_per_page |
모든 결과 전체/페이지별 콘텐츠 예산 | 네이티브 전용 |
네이티브 전용 필터를 채팅 완성 경로에서 사용하면 설명이 포함된 오류가 반환됩니다. freshness는 date_after/date_before와 함께 사용할 수 없습니다.
고급 구성
데몬 프로세스용 환경 변수
OpenRouter 프록시 설정
Perplexity 검색을 OpenRouter를 통해 라우팅하려면 네이티브 Perplexity 키 대신 OPENROUTER_API_KEY(접두사 sk-or-)를 설정하세요. OpenClaw는 키를 감지하여 자동으로 Sonar 전송 방식으로 전환합니다. 이미 OpenRouter 결제를 설정했고 공급자를 한곳으로 통합하려는 경우 유용합니다.
