문돌이의 Openclaw 삽질기(1): AI 비서에게 Google Workspace 권한 주기 - gog 연동 삽질기 🤖📧

들어가며

이미 어떻게 Openclaw로 연동하고 사용하는지는 다른 유튜버나 개발자 분들께서 잘 설명하고 계셔서 저는 그부분은 패스하겠습니다!

제가 Openclaw AI 비서를 만들어 가면서 생기는 좌충우돌 오류 해결기를 적어서 저 같이 for loop도 못짜는 비개발자 바이브코더분들이 마주하면서 생길 Openclaw의 오류를 조금이나마 해결하시길 바라며 만들었습니다 ㅎㅎ

먼저 저의 코딩 실력(?)은 for loop나 if 구문 같은 것은 실제로 적을 줄 모르는 바이브코더 입니다 ㅋㅋ 하지만 대학교때 머신러닝 강의를 들어서 이론적 배경은 있고 이미 있는 적당한 파이썬이나 C++ 코드를 보고 대충 “아 이게 이렇게 되는거구나” 같은 흐름 정도는 볼줄 알고 있습니다… 감안 해주시고 봐주시면 감사하겠습니다!

삽질기(1): AI에게 Gmail을 맡긴다고?

AI 비서가 내 이메일을 읽고, 일정을 체크하고, 중요한 메일에 답장도 할 수 있다면?

상상만 해도 멋지지 않나요? 그래서 오늘 도전했습니다. OpenClaw라는 오픈소스 AI 프레임워크에 gog CLI를 연동해서 Google Workspace(Gmail, Calendar, Drive 등)에 접근하는 작업을요.

결과는? 성공! 🎉

…하지만 그 과정이 순탄하지만은 않았습니다. ㅋㅋㅋ

1단계: gog 스킬을 발견하다

처음엔 다른 개발자님들이 주로 사용하고 계시던 MCP (Model Context Protocol) 서버를 쓸까 했는데, OpenClaw 스킬 폴더를 뒤지다가 숨겨진 보물을 발견했습니다.

/home/myuser/.npm-global/lib/node_modules/openclaw/skills/gog/

gog라는 Google Workspace 전용 CLI가 이미 있었던 겁니다! 😲

gog란?
Google Workspace를 터미널에서 제어할 수 있는 CLI 도구.
Gmail 검색, 이메일 전송, Calendar 일정 관리, Drive 파일 검색 등 거의 모든 걸 할 수 있습니다. Openclaw 자체 내장 Skill 입니다.

2단계: Google Cloud Console 설정 (첫 번째 실수)

OAuth 인증을 하려면 Google Cloud Console에서 설정이 필요합니다.

내가 한 일:

✅ 프로젝트 생성
✅ API 활성화 (Gmail, Calendar, Drive 등 - 이때 기존에 쓰시던 Gemini API Project에다가 바로 하시면 편합니다.)
✅ OAuth 클라이언트 ID 생성 (Desktop app)
✅ client_secret.json 다운로드
❌ OAuth 동의 화면 범위(Scopes) 설정… 안 함

그리고 자신만만하게 인증 시도:

gog auth add [email protected] --services gmail,calendar,drive,contacts,docs,sheets

결과:

액세스 차단됨: 승인 오류
Some requested scopes were invalid.
{valid=[...calendar], invalid=[...gmail, ...drive, ...contacts]}
400 오류: invalid_scope

😱 OAuth 동의 화면에 범위(Scopes)를 추가 안 했던 겁니다!

3단계: 범위 추가하고 재시도 (두 번째 실수)

급하게 Google Cloud Console로 돌아가서:

OAuth 동의 화면 → 앱 수정
“범위 추가 또는 삭제” 클릭
필요한 범위들 전부 추가:
- https://www.googleapis.com/auth/gmail.modify
- https://www.googleapis.com/auth/drive
- https://www.googleapis.com/auth/documents
- https://www.googleapis.com/auth/spreadsheets
- https://www.googleapis.com/auth/contacts
- …등등
테스트 사용자에 내 이메일 추가

다시 시도!

gog auth add [email protected] --services gmail,calendar,drive,contacts,docs,sheets

브라우저가 열리고, Google 로그인 화면이 뜹니다. 승인 완료! 다른 사용자 분들은 너무 성급하게 하시지 말고 찬찬히 AI 비서한테 물어봐주시면 됩니다!

💡 꿀팁: 브라우저가 안 뜰 때 (WSL 사용자 필독!)

저처럼 리눅스(WSL) 환경에서 하시는 분들은 gog auth add를 해도 브라우저가 자동으로 안 뜰 수 있습니다. 당황하지 마시고 터미널에 출력된 **아주 긴 링크(https://…)**를 복사해서, 윈도우 크롬 주소창에 붙여넣기 하세요. 그럼 로그인 화면이 잘 뜹니다!

결과:

Authorization received. Finishing…
store token: no TTY available for keyring file backend password prompt; 
set GOG_KEYRING_PASSWORD

😵 또 실패!

이번엔 토큰을 암호화된 keyring에 저장하려는데, 비밀번호를 입력받을 터미널이 없다는 오류였습니다.

4단계: 환경 변수로 해결 (드디어 성공!)

해결 방법은 간단했습니다. 환경 변수로 keyring 비밀번호를 설정하는 거죠.

export GOG_KEYRING_PASSWORD="openclaw"
gog auth add [email protected] --services gmail,calendar,drive,contacts,docs,sheets

브라우저가 열리고, 다시 승인하고…

결과:

Authorization received. Finishing…
email: [email protected]
services: calendar,contacts,docs,drive,gmail,sheets
client: default

🎉 드디어 성공!

5단계: 테스트 - 정말 되는가?

Gmail 검색:

export GOG_KEYRING_PASSWORD="openclaw"
gog gmail search 'newer_than:1d' --max 5 --account [email protected]

결과: 최근 24시간 이메일 5개가 깔끔하게 출력됩니다! ✅

Calendar 조회:

gog calendar events primary --from 2026-02-08T00:00:00+09:00 --to 2026-02-09T00:00:00+09:00 --account [email protected]

결과: No events (오늘 일정이 없었네요 ㅋㅋ) ✅

완벽합니다!

6단계: 중요한 안전 장치 🚨

여기서 끝이 아닙니다. AI에게 Gmail 권한을 준다는 건… 생각보다 위험할 수 있거든요.

상상해보세요:

실수로 재무팀 부장님에게 사랑 고백을 보낸다면? 😱
중요한 거래처에 욕을 보낸다면? 🔥
중요한 이메일을 삭제한다면? 💀

그래서 안전 규칙을 만드는 것을 추천드립니다!

🔴 필수 승인 작업 (AI가 절대 임의로 하지 않음):

Gmail 보내기 (gog gmail send)
Gmail 삭제 (모든 삭제 명령)
Drive 파일 삭제
Calendar 일정 삭제/수정

✅ 안전한 작업 (AI가 자유롭게 할 수 있음):

이메일 검색, 읽기
Calendar 일정 조회
Drive 파일 검색
임시 보관함 작성 (전송은 안 함!)

작동 방식:

AI가 이메일 초안 작성
나에게 보여줌: “이 내용을 보낼까요?”
내가 명시적으로 승인: “보내”, “OK”, “승인”
그제야 실행

“두 번 묻는 게 한 번 사과하는 것보다 낫다!”

7단계: OpenClaw에 통합과 최종 실험!

마지막으로 OpenClaw 설정 파일에 gog 스킬을 추가했습니다.

openclaw gateway config.patch

이제 AI 비서가:

“오늘 온 이메일 보여줘” 👀
“다음 주 일정 알려줘”
“Drive에서 예산 파일 찾아줘” 🔍

이런 요청을 자유롭게 처리할 수 있게 되었습니다!

일단 오늘 저한테 온 안 읽은 메일을 읽음 처리를 부탁해보겠습니다

gog_before gog_request gog_after

진짜 성공했습니다…!! (제가 눌러본게 아닙니다 ㅋㅋ)

배운 교훈 💡

1. OAuth는 생각보다 복잡하다

API 활성화만으로는 부족합니다.
OAuth 동의 화면에서 범위(Scopes)를 명시적으로 추가해야 합니다.
테스트 사용자도 잊지 말고 추가하세요!

2. 환경 변수는 만능 해결사

TTY가 없을 때는 환경 변수로 비밀번호를 전달하세요.
GOG_KEYRING_PASSWORD="your-password"

3. 안전 장치는 필수

AI에게 권한을 줄 때는 항상 최소 권한 원칙을 지키세요.
위험한 작업(전송, 삭제)은 반드시 승인 단계를 거치도록 하세요.

4. 문서를 꼼꼼히 읽자

gog --help를 먼저 읽었으면 시간을 많이 절약했을 겁니다 ㅋㅋ

마무리

오늘의 삽질 덕분에 제 AI 비서가 한층 더 똑똑해졌습니다! 🎉

이제 “오늘 온 안 읽은 메일 읽음 처리해줘” 같은 요청도 척척 처리합니다.

다음 목표:

자동 이메일 분류 (중요/스팸 구분)
일정 기반 자동 리마인더
Drive 파일 자동 정리

기술이 발전하면서 AI와 함께 일하는 시대가 정말로 왔습니다. (문돌이를 살…)

다음 삽질기로 찾아 뵙겠습니다!

여러분도 AI 비서를 키워보시는 건 어떨까요? 😊

참고 자료

P.S. 이 글을 쓰는 것도 제 AI 비서가 도와줬습니다. AI가 자기자신의 삽질기와 제 실수를 스스로 쓰는 시대… 참 재밌네요. ㅋㅋㅋ

들어가며#

삽질기(1): AI에게 Gmail을 맡긴다고?#

1단계: gog 스킬을 발견하다#

2단계: Google Cloud Console 설정 (첫 번째 실수)#

내가 한 일:#

결과:#

3단계: 범위 추가하고 재시도 (두 번째 실수)#

💡 꿀팁: 브라우저가 안 뜰 때 (WSL 사용자 필독!)#

결과:#

4단계: 환경 변수로 해결 (드디어 성공!)#

결과:#

5단계: 테스트 - 정말 되는가?#

Gmail 검색:#

Calendar 조회:#

6단계: 중요한 안전 장치 🚨#

🔴 필수 승인 작업 (AI가 절대 임의로 하지 않음):#

✅ 안전한 작업 (AI가 자유롭게 할 수 있음):#

작동 방식:#

7단계: OpenClaw에 통합과 최종 실험!#

진짜 성공했습니다…!! (제가 눌러본게 아닙니다 ㅋㅋ)#

배운 교훈 💡#

1. OAuth는 생각보다 복잡하다#

2. 환경 변수는 만능 해결사#

3. 안전 장치는 필수#

4. 문서를 꼼꼼히 읽자#

마무리#

참고 자료#

들어가며

삽질기(1): AI에게 Gmail을 맡긴다고?

1단계: gog 스킬을 발견하다

2단계: Google Cloud Console 설정 (첫 번째 실수)

내가 한 일:

결과:

3단계: 범위 추가하고 재시도 (두 번째 실수)

💡 꿀팁: 브라우저가 안 뜰 때 (WSL 사용자 필독!)

결과:

4단계: 환경 변수로 해결 (드디어 성공!)

결과:

5단계: 테스트 - 정말 되는가?

Gmail 검색:

Calendar 조회:

6단계: 중요한 안전 장치 🚨

🔴 필수 승인 작업 (AI가 절대 임의로 하지 않음):

✅ 안전한 작업 (AI가 자유롭게 할 수 있음):

작동 방식:

7단계: OpenClaw에 통합과 최종 실험!

진짜 성공했습니다…!! (제가 눌러본게 아닙니다 ㅋㅋ)

배운 교훈 💡

1. OAuth는 생각보다 복잡하다

2. 환경 변수는 만능 해결사

3. 안전 장치는 필수

4. 문서를 꼼꼼히 읽자

마무리

참고 자료