개요

OpenClaw 사용 시 검색을 이용하려고 하면 Brave Search API 키를 등록하라고 하는데 필자가 글을 쓰는 시점에는 무료 플랜이 없습니다. 공식 문서를 보니 Gemini 도 지원을 한다고 되어 있어 설정해 보기로 했습니다. 글을 쓰는 현재 OpenClaw 설정 글들 모두 Brave Search API 기준으로 되어 있었습니다.

현상 확인 및 Gemini 지원 확인

연결된 메신저(필자의 경우 텔레그램)에서 뉴스를 알려 달라고 하면 다음과 같은 메시지가 나타났었습니다.

분명히 Brave Search 만 지원하지는 않을 것 같아서 찾아보니 이곳에 Choosing a search provider 섹션에 Gemini 가 있는 것을 확인할 수 있었습니다.

설정

설정은 openclaw.json 파일을 수정하고 환경 변수를 추가한 후 재 시작하면 됩니다.

openclaw.json 파일에 다음과 같이 추가합니다. 모델은 적절하게 변경하시면 됩니다.

  "tools": {
    "allow": [
      "web_search", "web_fetch"
    ],
    "web": {
      "search": {
        "enabled": true,
        "provider": "gemini",
        "gemini": {
          "apiKey": "yourgeminikey",
          "model": "gemini-2.5-flash"
        }
      },
      "fetch": {
        "enabled": true
      }
    }
  },

현재 기준으로 3행의 “web_search”, “web_fetch” 부분이 없으면 아래쪽의 설정이 있어도 검색이 제대로 수행되지 않습니다. gemini API Key 는 aistudio.google.com 에서 발급하면 됩니다. 필자는 간단한 질문이나 뉴스 정도만 받아보는 용도로 설정했습니다. 무료도 충분히 사용 가능했습니다.

openclaw 디렉토리에 .env 파일을 만들고 다음 내용을 입력해서 환경변수를 추가합니다.

export GEMINI_API_KEY=”yourgeminikey”

바로 환경변수 변경 사항을 반영하거나 재 부팅 하면 됩니다.

이렇게 하면 다음과 같이 검색이 가능해 집니다.

주의 사항

공식 문서에서는 자동으로 search provider 를 인식한다고 되어 있었습니다. 그런데 설정의 문제인지 연결된 메신저의 문제인지 제대로 되지 않았습니다. 그래서 위와 같이 직접 설정 파일에 추가해서 해결했습니다.

혹시 계속 Brave Search API 를 찾으면 설정파일 및 환경변수에 Brave Search 관련한 것을 모두 삭제하고 OpenClaw 를 다시 시작해 보시기 바랍니다. Brave Search 설정이 다른 것을 다 무시하고 우선한다는 정보가 있어 알려드렸습니다.

Brave Search API 무료 플랜이 없어져서 설정 못하고 검색이 안되셨던 분들께 도움이 되었으면 합니다.