5분 만에 ClawdBot AI가 검색을 배우도록 하기, 이 무료 API 너무 좋다
안녕하세요, 샤오샤오입니다.
이전에 Moltbot(원래 Clawdbot)을 소개해 드렸는데, 텔레그램을 통해 컴퓨터를 제어할 수 있는 AI 도구입니다. 설치 후 계속 사용해 봤는데, 한 가지 문제가 발견되었습니다. 인터넷 검색을 할 수 없다는 것입니다.
예를 들어 "최신 AI 뉴스가 뭐야"라고 물어보면 훈련 데이터에 의존해서만 답변할 수 있고, 정보는 모두 오래된 것입니다. 마치 2023년 책만 읽은 사람에게 오늘 뉴스를 알려달라고 하는 것과 같습니다. 어떻게 정확할 수 있겠습니까?
나중에 문서를 뒤져보니 Clawdbot이 검색 엔진 구성을 지원하고, 공식적으로 Brave Search를 추천한다는 것을 알게 되었습니다. 오늘은 제 구성 과정을 공유해 드리겠습니다. 전 과정 5분이면 완료되고, API는 무료입니다.
사실 시중에 사용할 수 있는 검색 API는 많습니다. Google, Bing도 있지만, 제가 마지막으로 Brave를 선택한 이유는 간단합니다.
- 충분한 무료 할당량 Google API는 매일 100회 무료, Bing은 매월 1000회, Brave는 매월 2000회입니다. 개인 테스트용으로는 2000회면 충분합니다.
- 더 나은 개인 정보 보호 **Brave는 개인 정보를 중시하며, 사용자를 추적하지 않습니다. 저는 이 점이 마음에 듭니다. 도구 컨트롤러로서 개인 정보는 항상 제 최우선 사항입니다.
- 간단한 구성 **Google API처럼 많은 서비스를 열고 OAuth를 구성할 필요 없이, Brave는 간단한 API 키 인증으로 한 번에 완료됩니다.
- 괜찮은 검색 품질 **저는 10개 이상의 쿼리를 테스트했는데, 결과 품질이 생각보다 좋았습니다. 적어도 일상적인 사용에는 문제가 없습니다.
튜토리얼을 시작하기 전에 제가 겪었던 함정을 먼저 말씀드리겠습니다. Brave API 등록에는 VISA 카드 인증이 필요합니다**.
결제 시스템은 Stripe를 사용하고, 인증 시 1달러가 청구된 후 즉시 환불됩니다. 이는 당신이 로봇이 아님을 확인하기 위한 것이지만, 이 작업으로 인해 많은 사람들이 포기하게 됩니다.
이 단계는 실제로 간단하며, 따라하기만 하면 됩니다.
1. 계정 등록
Brave Search API 공식 웹사이트 방문: https://brave.com/search/api/
"Get Started"를 클릭하여 계정을 등록합니다. 이메일은 아무거나 입력해도 되며, 자주 사용하는 이메일을 사용하면 됩니다. 나중에 API 키를 확인해야 합니다.
2. VISA 카드 연결
구독 시 은행 카드 연결을 요청하는 메시지가 표시됩니다. 절차에 따라 진행하면 됩니다. 청구된 1달러는 몇 분 안에 환불되니 걱정하지 마세요.
3. 무료 플랜 구독 및 API 키 생성
로그인하면 콘솔이 표시되고, 무료 플랜을 구독합니다.

그런 다음 "Add API Key" 버튼을 클릭합니다.
여기에는 몇 가지 옵션이 있습니다.
- API 키 이름: 아무거나 입력하세요. 예를 들어 "Clawdbot"
- 사용 시나리오**: "Personal use"(개인 사용) 선택
- 할당량**: 무료 버전은 매월 2000회 호출
생성 버튼을 클릭하면 시스템에서 문자열을 제공합니다. 이것이 바로 API 키입니다.
API 키를 받으면 두 가지 구성 방법이 있습니다. 저는 둘 다 시도해 봤고, 차이점을 말씀드리겠습니다.
이것은 공식적으로 권장되는 방법이며, 제가 가장 자주 사용하는 방법입니다.
clawdbot configure --section web
실행 후 대화형 구성으로 들어가 Brave API 키를 입력하라는 메시지가 표시됩니다.
? Enter your Brave Search API key: [키 붙여넣기]
방금 복사한 키를 직접 붙여넣고 Enter 키를 누르면 완료됩니다.
장점**:
- 간단한 구성, 한 줄 명령으로 완료
- 구성 파일에 자동 저장
- 핫 업데이트 지원, 재시작 불필요
저는 당시 이 방법을 사용했는데, 실행부터 구성까지 30초도 걸리지 않았습니다.
수동으로 구성하거나 Docker와 같은 특수 환경에서 사용해야 하는 경우 환경 변수를 설정할 수 있습니다.
`# ~/.bashrc 또는 ~/.zshrc에 추가 export BRAVE_API_KEY="키"
구성 다시 로드
source ~/.bashrc`주의: 이 방법으로 구성한 후에는 Gateway를 다시 시작해야 적용됩니다.
재시작 명령:
clawdbot gateway restart
구성이 완료되면 테스트할 수 있습니다.
텔레그램을 통해 테스트
Clawdbot에 메시지 보내기:
검색: 2026년 최신 AI 기술 트렌드
몇 초 후 검색 결과가 반환됩니다. 포함된 내용:
- 관련 웹 페이지의 제목 및 링크
- 간단한 요약
- 출처 웹사이트
저는 이 기능을 처음 봤을 때 정말 충격을 받았습니다. AI가 드디어 실시간으로 정보를 얻을 수 있게 되었습니다.
명령줄 테스트
명령줄을 선호하는 경우 직접 테스트할 수도 있습니다.
clawdbot search "최신 AI 뉴스"
이 명령은 검색 결과를 직접 출력하여 디버깅에 편리합니다.
Brave 검색을 구성한 후 며칠 동안 사용해 보고 솔직한 느낌을 말씀드리겠습니다.
유용한 시나리오
- 빠른 정보 획득 "검색: 오늘 기술계에 무슨 큰 일이 있었나" 최신 뉴스 목록을 제공하여 직접 기술 매체를 검색하는 것보다 훨씬 빠릅니다.
- 기술 문제 쿼리 **"검색: Python에서 HTTP 요청을 비동기적으로 처리하는 방법" Stack Overflow와 같은 기술 커뮤니티를 검색하여 해결책을 요약합니다.
- 자료 수집 **"검색: 2026년 AI 창업 방향" 조사 시 정보를 빠르게 수집하는 데 적합합니다.
적합하지 않은 시나리오
- 복잡한 쿼리 **예를 들어 "iPhone과 Android의 장단점 비교"와 같이 심층적인 분석이 필요한 문제는 검색 효과가 일반적입니다.
- 실시간 요구 사항이 높은 **인터넷 검색 + 이해 + 응답에 몇 초에서 십여 초가 걸리므로 채팅 시 지연이 발생합니다.
- 데이터 정확성이 필요한 **예를 들어 주가, 날씨 정보와 같은 정보는 전용 API를 사용하는 것이 좋습니다. 검색에 의존하지 마세요.
Clawdbot에 Brave 검색을 구성하면
5분이면 완료되고, 무료 할당량으로 충분하며, 검색 품질도 괜찮습니다. 가장 중요한 것은 AI가 "채팅만 할 수 있는" 것에서 "일을 할 수 있는 정보 도우미"로 바뀌었다는 것입니다.
Clawdbot 또는 Moltbot을 사용하고 있다면 5분만 투자하여 구성하는 것이 좋습니다. 특히 기술 조사, 자료 수집을 할 때 이 기능은 정말 많은 시간을 절약해 줍니다.
마지막으로 API 키를 잘 보관해야 합니다**. 검색 API일 뿐이지만 유출되면 남용되어 할당량이 소진될 수 있습니다.





