맥미니 OpenClaw 비서 봇 만들기 (21) — 웹 검색 한 줄로 비서가 달라졌다

맥미니 OpenClaw 비서 봇 만들기 (21) — 웹 검색 한 줄로 비서가 달라졌다

한나(비서실장)에게 "내일 월드컵 일정은?"이라고 물었더니 "web_search가 비활성이라 못 합니다"라고 했다. 검색 능력이 없는 비서였던 것이다. 설정 한 줄 추가로 해결했다.

문제

한나의 tools.profile은 "coding"으로, web_search 도구 자체는 이미 노출돼 있었다. 문제는 검색 provider가 설정되지 않아 실제로는 작동하지 않는 상태였다는 점이다.

OpenClaw dist를 추적한 결과, web_search 활성화는 3개 레이어로 게이팅된다.

레이어조건현재 상태

프로파일 멤버십	coding 프로파일에 포함	통과
provider surface	검색 provider가 설정돼야 활성	미통과
provider 선택	allowKeylessAutoSelect가 true여야 키리스 자동선택	web_search는 false (web_fetch는 true)

web_fetch는 키 없이 자동으로 되는데 web_search는 안 되는 이유가 여기 있었다. web_search는 provider를 명시적으로 설정해야 한다.

해결

openclaw.json에 한 줄 추가했다.

"tools": {
  "profile": "coding",
  "web": {
    "search": {
      "provider": "duckduckgo"
    }
  }
}

DuckDuckGo는 API 키 없이 쓸 수 있는 유일한 provider다. 전역 설정이라 한나(main)와 송태섭(scout) 양쪽에 동시 적용된다.

설정 추가 후 핫리로드만으로는 안 됐다. 게이트웨이 재시작이 필요했다. exec-approvals 때와 같은 패턴이다 — 핫리로드는 값만 갱신하지, 부팅 시 안 만들어진 provider를 새로 초기화하지 않는다.

결과

재시작 후 한나에게 월드컵 관련 질문을 시켰다. 웹 검색으로 정보를 가져오고, 조별 순위표 정리, 3위 진출 경우의 수 계산까지 했다. 검색 능력이 없을 때와 비교하면 비서로서의 쓸모가 확연히 달라졌다.

교훈

• web_search와 web_fetch는 같은 web 도구지만 활성화 조건이 다르다. web_fetch는 키리스 자동선택이 켜져 있고, web_search는 꺼져 있다.
• openclaw.json에 새 기능을 추가할 때는 핫리로드가 아니라 게이트웨이 재시작까지가 세트다. 이번이 세 번째 확인이다(exec-approvals approvers, 슬랙 승인, web_search).
• 설정 한 줄이 비서의 능력을 근본적으로 바꿀 수 있다. 코드를 짜기 전에 설정부터 확인할 것.

→ web_search 활성화 완료. 한나가 검색·추론하는 비서가 됐다.