Brave Search API

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

API 키 발급

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

설정 예시

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

도구 파라미터

파라미터	설명
`query`	검색 쿼리 (필수)
`count`	반환할 결과 수 (1-10, 기본값: 5)
`country`	2자리 ISO 국가 코드 (예: “US”, “DE”)
`language`	검색 결과의 ISO 639-1 언어 코드 (예: “en”, “de”, “fr”)
`ui_lang`	UI 요소의 ISO 언어 코드
`freshness`	기간 필터: `day` (24시간), `week`, `month`, `year`
`date_after`	해당 날짜 이후 게시된 결과만 반환 (YYYY-MM-DD)
`date_before`	해당 날짜 이전 게시된 결과만 반환 (YYYY-MM-DD)

예시:

// 국가 및 언어별 검색
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건의 원래 무료 플랜)이 있다면 계속 유효하지만, LLM Context나 더 높은 속도 제한 같은 최신 기능은 포함되지 않습니다.
각 Brave 플랜에는 월 $5의 무료 크레딧(매월 갱신)이 포함됩니다. Search 플랜은 1,000건당 $5이므로, 크레딧으로 월 1,000건을 처리할 수 있습니다. 예상치 못한 요금을 방지하려면 Brave 대시보드에서 사용 한도를 설정하세요. 현재 플랜은 Brave API 포털에서 확인할 수 있습니다.
Search 플랜에는 LLM Context 엔드포인트와 AI 추론 권한이 포함됩니다. 모델 학습이나 튜닝을 위해 결과를 저장하려면 명시적 저장 권한이 있는 플랜이 필요합니다. Brave 이용약관을 참고하세요.
결과는 기본적으로 15분간 캐시됩니다(cacheTtlMinutes로 조정 가능).

전체 web_search 설정은 Web tools를 참고하세요.