🐧 Linux / WSL
🍎 macOS

gog CLI
Google OAuth
OpenClaw
keyring
systemd

📋 이런 분들에게 도움이 돼요

OpenClaw이나 비슷한 AI 에이전트 프레임워크에서 Google Calendar, Gmail, Drive 등을 CLI로 제어하고 싶은데, OAuth 인증 설정이 자꾸 막히는 분! 특히 headless 환경(WSL, 서버)에서 브라우저 없이 OAuth를 통과해야 하는 상황이라면, 이 글이 딱이에요.

🔍 배경: gog CLI가 뭐예요?

gog는 Google Workspace(Gmail, Calendar, Drive, Contacts, Sheets, Docs)를 커맨드라인에서 제어할 수 있는 CLI 도구예요. OpenClaw 같은 AI 에이전트 프레임워크에서 스킬로 자동 감지되지만, 실제로 쓰려면 OAuth 인증과 환경변수 설정을 별도로 해줘야 해요.

기존의 google-calendar 스킬과는 별개로, gog는 자체 OAuth 저장소(~/.config/gogcli/)를 사용해요.

⚙️ Step 1: credentials.json 생성

Google Cloud Console에서 OAuth 2.0 Client ID를 만들고, credentials.json 파일을 생성해요.

{
  "installed": {
    "client_id": "{your-client-id}.apps.googleusercontent.com",
    "client_secret": "{your-client-secret}",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "redirect_uris": ["http://localhost"]
  }
}

이 파일을 ~/.config/gog/credentials.json에 저장하면 돼요.

⚙️ Step 2: gog에 credentials 등록

gog auth credentials ~/.config/gog/credentials.json

실행하면 gog가 자동으로 ~/.config/gogcli/credentials.json으로 복사해줘요.

⚙️ Step 3: OAuth 인증 (manual 모드)

WSL이나 headless 서버처럼 브라우저가 없는 환경에서는 --manual 옵션을 써야 해요.

GOG_KEYRING_PASSWORD="{your-password}" gog auth add {your-email}@gmail.com \
  --services calendar,gmail,drive,contacts,docs,sheets \
  --manual --force-consent

실행하면 URL이 하나 출력되는데요:

1. 그 URL을 브라우저(다른 PC도 OK)에서 열어서 Google 계정으로 로그인
2. 권한 허용 후 localhost로 리다이렉트돼요 (페이지가 안 뜨는 게 정상!)
3. 브라우저 주소창의 전체 URL을 복사해서 터미널에 붙여넣기

📁 토큰 저장 구조

인증이 완료되면 토큰이 이렇게 저장돼요:

~/.config/gogcli/
├── credentials.json                          # OAuth 클라이언트 정보
└── keyring/
    └── token:default:{your-email}@gmail.com  # 암호화된 refresh token

토큰은 GOG_KEYRING_PASSWORD로 AES 암호화되어 저장돼요. 패스워드 없이 접근하면 에러가 나고, 패스워드가 틀려도 에러가 나요.

🔑 환경변수 설정 — 여기가 핵심!

gog가 keyring을 복호화하려면 GOG_KEYRING_PASSWORD 환경변수가 반드시 필요해요. 그리고 3곳 모두 설정해야 완벽하게 동작해요.

(1) openclaw.json — 에이전트 스킬 설정

"gog": {
  "enabled": true,
  "env": {
    "GOG_KEYRING_PASSWORD": "{your-password}",
    "GOG_ACCOUNT": "{your-email}@gmail.com"
  }
}

(2) ~/.bashrc — 대화형 셸용

# gog CLI keyring password
export GOG_KEYRING_PASSWORD="{your-password}"
export GOG_ACCOUNT="{your-email}@gmail.com"

(3) systemd 서비스 파일 — 가장 중요!

파일 위치: ~/.config/systemd/user/openclaw-gateway.service

Environment=GOG_KEYRING_PASSWORD={your-password}
Environment=GOG_ACCOUNT={your-email}@gmail.com

설정 변경 후에는 반드시:

systemctl --user daemon-reload
openclaw gateway restart

🔧 트러블슈팅

❌ aes.KeyUnwrap(): integrity check failed

# corrupt 토큰 삭제
rm ~/.config/gogcli/keyring/token\:{your-email}@gmail.com
# default 토큰만 남겨야 함 (token:default:{your-email}@gmail.com)

❌ no TTY available for keyring file backend password prompt

❌ context deadline exceeded (토큰 교환 타임아웃)

✅ 검증 명령어

설정이 잘 됐는지 확인하려면:

# 인증 상태 확인
GOG_KEYRING_PASSWORD="{your-password}" gog auth list

# 달력 이벤트 조회 테스트
GOG_KEYRING_PASSWORD="{your-password}" gog calendar events primary --max 5

# 키링 파일 확인
ls -la ~/.config/gogcli/keyring/

📌 핵심 요약

Google이 문을 아무리 꽉 잠가도, 올바른 열쇠(credential + 환경변수)만 있으면 결국 열려요! 🔑✨