Brave Search API 연동하기

AI 모델을 개발하다 보면 학습 데이터의 한계 때문에 최신 정보를 가져오지 못해 답답할 때가 많아요. 실시간 웹 검색 기능을 연결하는 과정이 복잡하면 개발 흐름이 끊기기도 하죠. OpenClaw에서 Brave Search를 사용하면 이런 문제를 해결하고 모델에게 최신 정보를 제공할 수 있습니다.

Brave Search API는 OpenClaw에서 web_search 기능을 사용할 때 기본으로 권장하는 프로바이더예요.

필요한 것

• Brave Search API 계정
• API Key (Data for Search 플랜)

빠른 시작

5분 안에 Brave Search를 설정하고 웹 검색 기능을 활성화해 보세요.

1. Brave Search API 사이트에서 계정을 생성하세요.
2. 대시보드에서 Data for Search 플랜을 선택하고 API Key를 생성합니다.
3. 생성한 키를 설정 파일에 직접 넣거나, Gateway 환경 변수에 BRAVE_API_KEY라는 이름으로 등록하세요.

권장하는 json5 설정 예시는 다음과 같습니다:

{
  tools: {
    web: {
      search: {
        provider: "brave",
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

문제 해결

• 플랜 호환성 문제: Data for AI 플랜은 web_search 기능과 호환되지 않아요. 반드시 Data for Search 플랜을 사용하고 있는지 확인하세요.
• API 호출 제한: Brave는 무료 티어와 유료 플랜을 모두 제공합니다. 현재 사용 중인 플랜의 제한 수치는 Brave API 포털에서 확인할 수 있어요.

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

다음 단계

• Web tools: web_search 전체 설정 옵션 확인하기