Tools

Brave 검색

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

API 키 받기

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

구성 예시

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

제공자별 Brave 검색 설정은 이제 plugins.entries.brave.config.webSearch.* 아래에 있습니다. 레거시 tools.web.search.apiKey는 여전히 호환성 심을 통해 로드되지만, 더 이상 표준 구성 경로가 아닙니다.

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

web(기본값): 제목, URL, 스니펫이 포함된 일반 Brave 웹 검색
llm-context: 근거 제시를 위한 사전 추출 텍스트 청크와 출처가 포함된 Brave LLM Context API

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

도구 매개변수

querystringrequired

검색 쿼리입니다.

countnumber

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

countrystring

2자리 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).

예시:

// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
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 캐시 ID에 포함되므로 프록시별 응답이 충돌하지 않습니다.
문제 해결 중 Brave 요청 URL/쿼리 매개변수, 응답 상태/타이밍, 검색 캐시 적중/누락/쓰기 이벤트를 기록하려면 brave.http 진단 플래그를 활성화하세요. 이 플래그는 API 키나 응답 본문을 절대 기록하지 않지만, 검색 쿼리는 민감할 수 있습니다.

Brave 검색

API 키 받기

구성 예시

도구 매개변수

참고

관련 항목

Ask OpenClaw

# API 키 받기

# 구성 예시

# 도구 매개변수

# 참고

# 관련 항목

API 키 받기

구성 예시

도구 매개변수

참고

관련 항목