OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Brave 검색

OpenClaw은 web_search 제공자로 Brave Search API를 지원합니다.

API 키 발급

  1. https://brave.com/search/api/에서 Brave Search API 계정을 만듭니다.
  2. 대시보드에서 Search 요금제를 선택하고 API 키를 생성합니다.
  3. 키를 구성에 저장하거나 Gateway 환경에 BRAVE_API_KEY를 설정합니다.

구성 예시

json5
{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // 또는 "llm-context"            baseUrl: "https://api.search.brave.com", // 선택적 프록시/기본 URL 재정의          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Brave 제공자별 검색 설정은 plugins.entries.brave.config.webSearch.*에 있으며, 이것이 표준 구성 경로입니다. 공유 최상위 tools.web.search.apiKey와 범위가 지정된 tools.web.search.brave.*도 호환성 병합을 통해 계속 로드되지만, 새 구성에서는 위의 Plugin 범위 경로를 사용해야 합니다.

webSearch.mode는 Brave 전송 방식을 제어합니다.

  • web(기본값): 제목, URL, 스니펫이 포함된 일반 Brave 웹 검색
  • llm-context: 근거 제공을 위해 미리 추출된 텍스트 청크와 출처를 제공하는 Brave LLM Context API

webSearch.baseUrl을 사용하여 Brave 요청을 신뢰할 수 있는 Brave 호환 프록시 또는 게이트웨이로 보낼 수 있습니다. OpenClaw은 구성된 기본 URL에 /res/v1/web/search 또는 /res/v1/llm/context를 추가하고 기본 URL을 캐시 키에 포함합니다. 공개 엔드포인트에는 반드시 https://를 사용해야 하며, http://는 신뢰할 수 있는 루프백 또는 사설 네트워크 프록시 호스트에만 허용됩니다.

도구 매개변수

querystringrequired

검색 쿼리입니다.

countnumberdefault: 5

반환할 결과 수입니다(1~10).

countrystring

두 글자 ISO 국가 코드입니다(예: US, DE).

languagestring

검색 결과에 사용할 ISO 639-1 언어 코드입니다(예: en, de, fr).

search_langstring

Brave 검색 언어 코드입니다(예: en, en-gb, zh-hans).

ui_langstring

UI 요소에 사용할 ISO 언어 코드입니다.

freshness'day' | 'week' | 'month' | 'year'

시간 필터입니다. day는 24시간을 의미합니다.

date_afterstring

이 날짜 이후에 게시된 결과만 반환합니다(YYYY-MM-DD).

date_beforestring

이 날짜 이전에 게시된 결과만 반환합니다(YYYY-MM-DD).

예시:

javascript
// 국가 및 언어별 검색await web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // 최근 결과(지난 1주)await web_search({  query: "AI news",  freshness: "week",}); // 날짜 범위 검색await web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",});

참고 사항

  • OpenClaw은 Brave Search 요금제를 사용합니다. 기존 구독(예: 월 2,000회 쿼리를 제공하는 기존 Free 요금제)이 있는 경우 계속 유효하지만, LLM Context나 더 높은 요청 한도와 같은 최신 기능은 포함되지 않습니다.
  • 각 Brave 요금제에는 매월 갱신되는 월 $5 무료 크레딧이 포함됩니다. Search 요금제는 요청 1,000건당 $5이므로 이 크레딧으로 월 1,000회 쿼리를 사용할 수 있습니다. 예상치 못한 요금이 발생하지 않도록 Brave 대시보드에서 사용 한도를 설정하세요. 현재 요금제는 Brave API 포털을 참조하세요.
  • Search 요금제에는 LLM Context 엔드포인트와 AI 추론 권한이 포함됩니다. 모델을 학습하거나 튜닝하기 위해 결과를 저장하려면 명시적인 저장 권한이 있는 요금제가 필요합니다. Brave 서비스 약관을 참조하세요.
  • llm-context 모드는 일반적인 웹 검색 스니펫 형식 대신 근거가 포함된 출처 항목을 반환합니다.
  • llm-context 모드는 freshness와 범위가 제한된 date_after + date_before 조합을 지원합니다. ui_lang은 지원하지 않으며, date_after 없이 date_before만 지정하면 거부됩니다. Brave에서는 사용자 지정 최신성 범위에 시작 날짜와 종료 날짜가 모두 포함되어야 하기 때문입니다.
  • ui_lang에는 en-US와 같은 지역 하위 태그가 포함되어야 합니다.
  • 결과는 기본적으로 15분 동안 캐시됩니다(cacheTtlMinutes로 구성 가능).
  • 사용자 지정 webSearch.baseUrl 값은 Brave 캐시 식별 정보에 포함되므로 프록시별 응답이 서로 충돌하지 않습니다.
  • 문제 해결 중 Brave 요청 URL/쿼리 매개변수, 응답 상태/소요 시간, 검색 캐시 적중/누락/쓰기 이벤트를 기록하려면 brave.http 진단 플래그를 활성화하세요. 이 플래그는 API 키나 응답 본문을 절대 기록하지 않지만, 검색 쿼리에는 민감한 정보가 포함될 수 있습니다.

관련 문서

Was this useful?
On this page

On this page