← 튜토리얼로 돌아가기

Google Workspace 연결

사전 준비 (두 방법 모두)

1

Google Cloud OAuth 인증정보 생성

이 단계는 자신의 브라우저에서 수행합니다 — MyClaw 인스턴스에서 할 것은 아직 없습니다.

  1. Google Cloud Console → APIs & Services → Credentials를 여세요.
  2. + CREATE CREDENTIALS → OAuth client ID → Application type: Desktop app을 클릭하세요.
  3. Create를 클릭 → JSON을 다운로드하세요. client_secret_xxx.json 파일을 저장하세요 — 다음 단계에서 필요합니다.
Google Cloud Console 열기

APIs & Services → OAuth consent screen에서 OAuth 동의 화면을 구성하고 자신을 Test user로 추가해야 합니다. 이것 없이는 인증이 실패합니다.

2

Gmail API 및 Google Calendar API 활성화

아래 각 링크를 클릭하고 Enable을 누르세요. 각각 몇 초면 됩니다.

Gmail API 활성화Google Calendar API 활성화

캘린더만 필요하세요? Calendar API만 활성화하세요(이후 단계에서 --services calendar 사용).

명령어가 필요 없습니다. 채팅 창(Telegram / WebChat)에서 모든 것을 하세요.

B.1

OpenClaw에게 gog 설치 요청

OpenClaw
나
Install gog for me
OpenClaw
Installing... ✅ gog v0.11.0 installed!
B.2

인증정보 파일 보내기

OpenClaw
나
client_secret_xxx.json
Connect my Gmail and Calendar
OpenClaw
Got the credentials file, configuring... ✅ Credentials imported. What's your Gmail address?
B.3

이메일 제공, 인증 링크 받기

OpenClaw
나
your@gmail.com
OpenClaw
Please open this link in your browser to authorize: https://accounts.google.com/o/oauth2/auth?... After authorizing, the page will redirect to 127.0.0.1 and show an error — that's normal. Copy the full URL from your address bar and send it to me.
B.4

콜백 URL 붙여넣기

OpenClaw
나
http://127.0.0.1:42845/oauth2/callback?state=xxx&code=xxx...
OpenClaw
✅ Gmail + Calendar connected! You can now just say: • "Check my recent emails" • "Create a meeting for tomorrow at 3 PM"

이게 전부입니다 — 메시지 세 번이면 연결 완료.

이제 할 수 있는 것들

기능이렇게 말하세요
📧 이메일 확인"최근 이메일을 확인해" / "xxx로부터 온 이메일이 있어?"
📧 이메일 보내기"a@b.com에게 ...에 대한 이메일을 보내줘"
📅 캘린더 보기"이번 주 일정이 뭐야?"
📅 이벤트 만들기"금요일 오후 2시에 회의를 잡아줘"
📧 이메일 초안 작성"그 이메일에 답장 초안을 작성해"

문제 해결

Q: 인증 중 "Access blocked" 또는 "App not verified"

A: OAuth 동의 화면에서 자신을 Test user로 추가하지 않았습니다. 1단계로 돌아가서 OAuth consent screen → Test users를 열고 Gmail 주소를 추가하세요.

Q: 403 accessNotConfigured 오류

A: API가 활성화되지 않았습니다. 2단계로 돌아가서 Gmail API와 Calendar API 모두 "Enabled"로 표시되어 있는지 확인하세요.

Q: 콜백 URL 만료

A: 인증 단계를 다시 수행하면 됩니다 — 빠릅니다. OpenClaw에게 "re-authorize"라고 말하면 새 링크를 제공합니다.

Q: WebSSH에서 no TTY available for keyring 오류

A: 명령어 앞에 GOG_KEYRING_PASSWORD="anypassword"를 붙이세요, 예:

GOG_KEYRING_PASSWORD="mypass123" gog auth add your@gmail.com ...