메인 콘텐츠로 건너뛰기

​
Perplexity Sonar

OpenClaw는 web_search 도구에 Perplexity Sonar를 사용할 수 있습니다. Perplexity의 직접 API를 통해 연결하거나 OpenRouter를 통해 연결할 수 있습니다.

​
API 옵션

​
Perplexity (직접 연결)

​
OpenRouter (대안)

​
설정 예시

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
          model: "perplexity/sonar-pro",
        },
      },
    },
  },
}
openclaw configure --section web로도 설정할 수 있습니다. 이 값은 ~/.openclaw/openclaw.json의 tools.web.search.perplexity.apiKey에 저장되며, 해당 필드는 SecretRef 객체도 허용합니다.

​
Brave에서 전환하기

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
        },
      },
    },
  },
}
PERPLEXITY_API_KEY와 OPENROUTER_API_KEY가 모두 설정되어 있는 경우, tools.web.search.perplexity.baseUrl (또는 tools.web.search.perplexity.apiKey)을 설정하여 명확히 하십시오. 기본 URL이 설정되지 않은 경우, OpenClaw는 API 키 소스에 따라 기본값을 선택합니다:
  • PERPLEXITY_API_KEY 또는 pplx-... → 직접 Perplexity (https://api.perplexity.ai)
  • OPENROUTER_API_KEY 또는 sk-or-... → OpenRouter (https://openrouter.ai/api/v1)
  • 알 수 없는 키 형식 → OpenRouter (안전한 대체)
provider: "perplexity"가 구성되어 있고 Perplexity 키 SecretRef가 env fallback 없이 해석되지 않으면, startup/reload는 즉시 실패합니다.

​
모델

  • perplexity/sonar — 웹 검색으로 빠른 질의응답
  • perplexity/sonar-pro (기본값) — 다단계 추론 + 웹 검색
  • perplexity/sonar-reasoning-pro — 심층 연구
전체 웹 검색 구성을 위해 웹 도구를 참조하십시오.