OpenClaw(오픈클로)를 사용하다 보면 "AI가 실시간 정보도 검색해주면 좋겠다"는 생각이 드실 겁니다. 오늘은 Brave Search API를 연동해서 OpenClaw에 웹 검색 기능을 추가하는 방법을 알려드립니다.

제가 설치했던 경험 그대로 말씀 드리도록 하겠습니다.

시작하기 전에 준비할 것

이 튜토리얼을 따라하려면 아래 조건이 갖춰져 있어야 합니다.

WSL Ubuntu가 설치되어 있고, OpenClaw가 이미 설치된 상태여야 합니다.

그래야 현재 powershell이 떠 있을 것이기 때문입니다.

OpenClaw 설치가 안 되어 있다면 먼저 설치를 완료해 주세요.

OpenClaw(molt bot, clawd bot) 설치하고 텔레그램으로 AI 비서 만든 후기 (삽질 포함)

작성 기준일: 2026년 2월 1일 사용 환경: Windows PC (MSI 미니PC, Intel N100, RAM 16GB) 요즘 IT 커뮤니티에서 핫한 OpenClaw(오픈클로)를 직접 설치해봤습니다. 원래 ClawdBot(클로드봇)이라는 이름으로 시작해서 MoltBot(몰트봇)을 거쳐 지금의 이름이 된 프로젝트인데요. 한마디로 설명하면, 내 컴퓨터에 설치해서 텔레그램(Telegram)이나 왓츠앱(WhatsApp) 같은 메신저로

syn2bloomJS

1단계: Brave Search API 키 발급받기

먼저 Brave Search에서 API 키(API key, 서비스 이용을 위한 고유 인증 코드)를 발급받아야 합니다.

1-1. Brave Search API 사이트 접속

웹 브라우저를 열고 아래 주소로 이동하세요.

https://brave.com/search/api/

1-2. 회원가입 및 로그인

계정이 없다면 회원가입을 진행합니다. 이미 계정이 있다면 로그인해 주세요.

1-3. Free 플랜 구독하기

로그인 후 왼쪽 메뉴에서 "Subscriptions"를 클릭합니다. Free 플랜을 선택해서 구독하세요. Free 플랜은 월 2,000건까지 무료로 검색할 수 있습니다.

1-4. API 키 생성하기

왼쪽 메뉴에서 "API Keys"를 클릭합니다. 새 키를 생성한 뒤, 생성된 API 키를 복사해 두세요. 이 키는 잠시 후 OpenClaw 설정에서 사용합니다.

팁: API 키는 비밀번호처럼 중요합니다. 다른 사람과 공유하지 마세요.

2단계: OpenClaw에 웹 검색 기능 설정하기

API 키를 준비했다면 이제 OpenClaw에 연동해 볼게요.

2-1. WSL Ubuntu 터미널 열기

현재 OpenClaw가 실행 중이라면 PowerShell 창이 열려 있을 거예요. 그 상태에서 WSL Ubuntu 터미널을 새로 열어주세요.

2-2. 웹 검색 설정 명령어 입력

터미널에 아래 명령어를 입력합니다.

openclaw configure --section web

2-3. 대화형 설정 진행하기

명령어를 입력하면 OpenClaw 설정 화면이 나타납니다. 화면에서 다음 항목들을 확인하고 설정하세요.

"Enable web_search (Brave Search)?" 질문이 나오면 Yes를 선택합니다. 그다음 API 키를 붙여넣으라는 메시지가 나오면 아까 복사해 둔 키를 붙여넣으세요.

설정을 마치면 "Configure complete." 메시지가 표시됩니다.

3단계: 게이트웨이 재시작하기

설정을 완료했으면 게이트웨이(Gateway, OpenClaw의 핵심 서비스)를 재시작해야 변경사항이 적용됩니다.

터미널에 아래 명령어를 입력하세요.

openclaw gateway restart

"Restarted systemd service: openclaw-gateway.service" 메시지가 나오면 성공입니다.

설정이 잘 됐는지 확인해 보기

이제 OpenClaw에서 웹 검색 기능을 사용할 수 있습니다. AI에게 최신 뉴스나 실시간 정보를 물어보면 Brave Search를 통해 검색한 결과를 바탕으로 답변해 줄 수 있습니다.

예를 들어 "오늘 날씨 어때?" 또는 "최근 AI 관련 뉴스 알려줘" 같은 질문을 해보시기 바랍니다.

마무리

오늘 배운 내용을 정리하면 다음과 같습니다.

1. Brave Search API 사이트에서 회원가입 후 Free 플랜 구독
2. API Keys 메뉴에서 키 생성 및 복사
3. openclaw configure --section web 명령어로 웹 검색 활성화
4. openclaw gateway restart로 게이트웨이 재시작

참고: Brave Search Free 플랜의 월 2,000건 무료 제공 조건은 Brave 정책에 따라 변경될 수 있습니다. 최신 정보는 Brave Search API 공식 사이트에서 확인해 주세요.