Day 4
OpenClaw Gmail, 캘린더, 웹 검색 연동 가이드
OpenClaw에 Gmail, Google 캘린더, Brave 검색, 브라우저를 연결하는 단계별 가이드. OAuth 설정과 각 연동 테스트 명령어 포함.
"대화만 할 수 있는 AI와, 이메일을 읽고 일정까지 관리하며 웹 검색도 하는 AI의 차이는 IQ가 아니라 손의 유무입니다. 오늘은 그 손을 만들어 줍니다."
오늘의 목표
| Learn | OpenClaw가 Gmail, 캘린더, 검색, Browser 연동을 통해 실제 작업 능력을 얻는 방식을 이해합니다. |
| Do | gog 를 설치하고, 웹 검색을 설정하고, 브라우저 자동화가 동작하는지 확인한 뒤, 각 항목을 실제로 한 번씩 테스트합니다. |
| Done when | 실제 받은편지함, 실제 캘린더, 현재 웹 검색 결과, 실제 URL을 오류 없이 조회할 수 있습니다. |
말만 하는 단계에서 실제로 해내는 단계로
이제 AI 어시스턴트가 챗봇처럼 답만 하는 것이 아니라, Gmail, 캘린더, 웹 검색, Browser 연동을 통해 실제 데이터를 다루게 됩니다.
OpenClaw에서는 새 기능 하나하나가 Skill 에서 나옵니다. Skill은 외부 서비스와 어떻게 상호작용할지 알려 주는 파일 묶음입니다. 오늘 연결할 것은 네 가지입니다.
| Skill | 열리는 기능 | 예시 |
|---|---|---|
| Gmail | 이메일 읽기, 검색, 요약 | "오늘 답장이 필요한 메일이 뭐야?" |
| Google Calendar | 일정 보기, 만들기, 수정 | "이번 주 회의가 뭐가 있어?" |
| Web Search | 원하는 정보 검색 | "이번 달 OpenClaw 소식이 뭐야?" |
| Browser | URL 열기, 내용 추출, 스크린샷 촬영 | "경쟁사 X의 요금제 페이지에는 뭐라고 써 있어?" |
핵심 4가지 연결하기
Gmail
- 먼저 필요한 것: Gmail API가 활성화된 Google Cloud 프로젝트와
credentials.json으로 저장한 Desktop OAuth 자격 증명 - 설치 명령어:
clawhub install gog - 할 일: 설치를 실행하고 브라우저 OAuth를 한 번 끝낸 뒤, OpenClaw가
token.json을 만들었는지 확인 - 테스트 프롬프트: "오늘 중요한 이메일 3개만 보여 줘."
Google Calendar
- 먼저 필요한 것: 같은 Google Cloud 프로젝트에 Google Calendar API도 활성화
- 설치 명령어:
clawhub install gog - 할 일: Gmail에서 사용한 Google 인증을 재사용해 실제 일정을 읽을 수 있게 하기
- 테스트 프롬프트: "이번 주에 예정된 회의를 보여 줘."
Gmail + Calendar 설정 (5단계):
console.cloud.google.com으로 이동 → 새 프로젝트 생성- API Library에서 "Gmail API" 와 "Google Calendar API" 활성화
- "Credentials" → OAuth client ID 생성 → Desktop app 선택 →
credentials.json다운로드 credentials.json을~/.openclaw/workspace/credentials.json으로 이동clawhub install gog실행 — 브라우저 인증 창이 열림
인증이 끝나면 token.json 이 자동으로 생성됩니다. 반드시 비공개로 보관하세요. chmod 600 ~/.openclaw/workspace/token.json
Web Search
- 먼저 필요한 것: Brave Search 같은 검색 제공자 계정과 유효한 API key
- 설치 명령어:
openclaw configure --section web - 할 일: 마법사에 API key를 붙여 넣고 제공자 설정을 저장한 뒤 테스트
- 테스트 프롬프트: "이번 주 AI 업계에 무슨 일이 있었어?"
Browser
- 먼저 필요한 것: 정상 작동하는 OpenClaw 설치 (브라우저 기능은 기본 내장, 별도 설치 불필요)
- 활성화 명령어:
openclaw browser --browser-profile openclaw status - 할 일: 브라우저 상태를 확인하고, "disabled" 라면 설정에서 켠 뒤
openclaw gateway restart로 gateway 재시작 - 테스트 프롬프트: "https://example.com 에 뭐라고 적혀 있어?"
왜 이 단계가 체감을 바꾸는가
Day 4 이전에는 "이메일 답장 초안 써 줘"라고 하면 흔한 템플릿이 나왔습니다. Day 4 이후에는 "이메일 확인하고, 파트너 문의에 대한 답장 초안을 만들어 줘"라고 했을 때 실제 대화 스레드를 읽고, 캘린더에서 일정 여유를 확인하고, 부족한 맥락은 검색으로 채우고, 필요한 세부 정보는 실제 웹페이지에서 가져올 수 있습니다.
차이는 프롬프트가 좋아져서가 아닙니다. 실제 입력이 생겼기 때문입니다.
보안을 먼저 챙기기
Gmail, 캘린더, Browser까지 연결되면 어시스턴트가 민감한 데이터를 다룰 수 있습니다. 첫날부터 아래 습관을 들이세요.
- API key를 Git에 넣지 않기. 환경 변수나
.env파일을 사용하세요. - OAuth token 보호하기.
chmod 600 ~/.openclaw/workspace/token.json으로 내 사용자만 읽게 만드세요. - 최소 권한 원칙 따르기. Gmail 읽기만 필요하면 전송 권한은 주지 마세요.
- 경계를
SOUL.md에 적기. 예: "외부 메시지는 보내기 전에 반드시 확인."
최소 성공 기준
- Gmail: "오늘 중요한 이메일 3개만 보여 줘."라고 물었을 때 실제 결과가 나온다
- Calendar: "이번 주에 예정된 회의를 보여 줘."라고 물었을 때 실제 일정이 보인다
- Search: "이번 주 AI 업계에 무슨 일이 있었어?"라고 물었을 때 최신 정보가 나온다
- Browser: "[아무 URL] 에 뭐라고 적혀 있어?"라고 물었을 때 내용을 추출해 준다
50개 이상의 연동 전체 보기
오늘은 가장 범용적이고 가장 실용적인 네 가지 연결만 다뤘습니다. OpenClaw는 전체적으로 50개 이상의 연동을 지원합니다.
openclaw.ai/integrations - 전체 연동 디렉터리 →
채널, 모델 제공자, 도구 연동이 모두 여기에 정리되어 있습니다.
자주 생기는 문제
- OAuth token 권한 오류: Google 인증은 성공했는데 요청이 실패한다면, 오래된
~/.openclaw/workspace/token.json을 지우고clawhub install gog를 다시 실행한 뒤chmod 600 ~/.openclaw/workspace/token.json을 적용하세요. - 검색 API key가 인식되지 않음:
openclaw configure --section web를 다시 실행하고, 고른 제공자에 맞는 정확한 key를 붙여 넣은 다음, 새 대화에서 검색 테스트 프롬프트를 다시 시도하세요. - Browser가 응답하지 않음: OpenClaw가 브라우저에 접근하지 못하면
openclaw browser --browser-profile openclaw status로 상태를 확인하고,openclaw gateway restart로 재시작하세요. 그 후 "https://example.com 에 뭐라고 적혀 있어?"라고 물어보세요. - 캘린더가 비어 보임: Gmail OAuth에 사용한 것과 같은 Google Cloud 프로젝트에서 Calendar API가 활성화됐는지 확인하고, 다시 "이번 주에 예정된 회의를 보여 줘."로 테스트하세요.
오늘 달라진 점
이제 어시스턴트는 받은편지함, 캘린더, 검색 결과, 실제 웹페이지를 넘나들 수 있습니다. 내일은 이 핵심 도구를 넘어, 당신의 업무 흐름에 맞는 스킬을 직접 설치하게 됩니다.