Perplexity Sonar로 OpenClaw 웹 검색 강화하기

개발을 하다 보면 최신 정보가 절실한 순간이 있습니다. 하지만 LLM이 학습한 데이터만으로는 어제 출시된 라이브러리나 오늘 바뀐 API 명세를 알기 어렵죠. 실시간 정보를 찾기 위해 브라우저 탭을 오가며 검색어를 입력하는 과정은 개발 흐름을 끊기게 합니다.

OpenClaw의 web_search 도구에 Perplexity Sonar를 연결하면 이런 문제를 해결할 수 있습니다. Perplexity direct API를 사용하거나 OpenRouter를 통해 간편하게 연결하는 방법을 소개합니다.

필요한 것

시작하기 전에 다음 중 하나가 필요합니다.

• Perplexity API Key (PERPLEXITY_API_KEY)
• OpenRouter API Key (OPENROUTER_API_KEY)

빠른 시작

5분 안에 실시간 웹 검색을 활성화할 수 있습니다. 가장 성능이 좋은 perplexity/sonar-pro 모델을 사용하는 설정 예시입니다. config.json5 파일에 아래 내용을 추가하세요.

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
          model: "perplexity/sonar-pro",
        },
      },
    },
  },
}

API 옵션 선택

두 가지 경로 중 본인에게 맞는 방법을 선택하세요.

1. Perplexity (direct)

   • Base URL: https://api.perplexity.ai
   • 환경 변수: PERPLEXITY_API_KEY

2. OpenRouter (alternative)

   • Base URL: https://openrouter.ai/api/v1
   • 환경 변수: OPENROUTER_API_KEY
   • 선불 크레딧이나 암호화폐 결제가 필요한 경우 유용합니다.

문제 해결

Brave에서 전환할 때

기존에 Brave Search를 사용했다면 provider를 perplexity로 바꾸고 API 설정을 업데이트하세요.

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
        },
      },
    },
  },
}

API Key 충돌 문제

PERPLEXITY_API_KEY와 OPENROUTER_API_KEY가 모두 설정되어 있다면, OpenClaw가 혼동할 수 있습니다. 이럴 때는 tools.web.search.perplexity.baseUrl이나 apiKey를 명시적으로 설정해서 경로를 명확히 해주세요.

Base URL을 설정하지 않으면 API Key 형식에 따라 자동으로 선택됩니다.

• pplx-... 형식: Perplexity direct API로 연결됩니다.
• sk-or-... 형식: OpenRouter로 연결됩니다.
• 알 수 없는 형식: 안전한 폴백을 위해 OpenRouter로 연결됩니다.

모델 선택 가이드

상황에 맞는 모델을 선택해 보세요.

• perplexity/sonar: 웹 검색을 포함한 빠른 문답에 좋습니다.
• perplexity/sonar-pro: 기본값이며, 다단계 추론과 웹 검색이 결합되어 있습니다.
• perplexity/sonar-reasoning-pro: 깊이 있는 리서치가 필요할 때 사용하세요.

설정 과정에서 도움이 필요하다면 AI Setup Assistant에게 질문해 보세요.

다음 단계

• Web tools 전체 설정 확인하기