서문
Google Chat은 Google Workspace 생태계의 핵심 커뮤니케이션 도구로, 수많은 기업과 팀이 일상적인 협업에 사용하고 있습니다. OpenClaw을 Google Chat에 연결하면 팀원들이 익숙한 작업 환경에서 도구를 전환하지 않고도 직접 AI 어시스턴트와 상호작용할 수 있습니다.
OpenClaw은 HTTP Webhook 방식으로 Google Chat과 네이티브 통합(Native Integration)을 수행합니다. 이는 플러그인 형태가 아니라 Google Chat 앱으로 직접 채팅 경험에 통합되는 방식입니다. OpenClaw 멀티 채널 게이트웨이의 일부로서, Google Chat 채널은 Telegram, Slack, Discord 등 다른 채널과 동시에 실행할 수 있으며 서로 간섭하지 않습니다.
사전 요구사항
- OpenClaw이 설치되어 정상 실행 중
- Google Workspace 계정 보유(Chat 앱 게시를 위해 관리자 권한 필요)
- OpenClaw 서비스가 공인 HTTPS 주소로 접근 가능(Webhook 방식의 필수 조건)
- Google Cloud Console에서 프로젝트 생성 완료
통합 방식 설명
OpenClaw과 Google Chat의 통합은 HTTP Webhook 앱 모드를 사용합니다. 사용자가 메시지를 보내면 Google Chat이 HTTP POST 요청을 통해 이벤트를 OpenClaw이 제공하는 Webhook 엔드포인트로 전송하고, OpenClaw이 처리한 후 응답을 사용자에게 반환합니다.
메시지 흐름은 다음과 같습니다:
사용자가 Google Chat에서 메시지 전송
↓
Google Chat 서버
↓
HTTP POST로 OpenClaw Webhook 엔드포인트에 전송
↓
OpenClaw이 메시지를 처리하고 AI 모델 호출
↓
Google Chat에 응답 반환
↓
사용자가 Google Chat에서 응답 수신
네이티브 통합이므로 Bot은 Google Chat에서 Google 공식 앱과 동일하게 작동하며, 1:1 채팅, 그룹 채팅, 채팅방 등 다양한 시나리오를 지원합니다.
1단계: Google Cloud Console에서 설정
1.1 Google Chat API 활성화
- Google Cloud Console에 로그인합니다
- 프로젝트를 선택하거나 새로 생성합니다
- 왼쪽 메뉴에서 APIs & Services → Library로 이동합니다
- Google Chat API를 검색하고 클릭합니다
- Enable을 클릭하여 API를 활성화합니다
1.2 Google Chat 앱 설정
API 활성화 후 Google Chat API 설정 페이지로 이동합니다:
- Configuration 탭을 클릭합니다
- 앱의 기본 정보(이름, 아바타, 설명 등)를 입력합니다
- Connection settings에서 HTTP endpoint URL을 선택합니다
- OpenClaw의 Webhook 주소를 입력합니다
1.3 서비스 계정 설정
Google Chat의 요청을 검증하기 위해 서비스 계정을 설정해야 합니다:
- Google Cloud Console에서 IAM & Admin → Service Accounts로 이동합니다
- 서비스 계정을 생성하거나 선택합니다
- JSON 형식의 키 파일을 다운로드합니다. 이후 OpenClaw 설정 시 필요합니다
2단계: OpenClaw에서 채널 설정
OpenClaw은 편리한 채널 로그인 명령어를 제공하여 Google Chat 설정을 완료할 수 있습니다. 터미널에서 다음을 실행합니다:
openclaw channels login
이 명령어는 대화형 설정 프로세스를 시작하며, 다음 단계를 안내합니다:
- 설정할 채널 선택(Google Chat 선택)
- Webhook 관련 정보 입력
- Google Cloud 서비스 계정 자격 증명 제공
- 연결 성공 여부 확인
설정 완료 후 OpenClaw이 자동으로 자격 증명을 설정 파일에 저장합니다.
재시작 및 확인
openclaw restart
# Google Chat 채널의 연결 로그 확인
openclaw logs -f --component channel:google-chat
성공적으로 시작되면 로그에서 Google Chat 채널이 준비되었다는 정보를 확인할 수 있으며, 이는 Webhook 엔드포인트가 Google Chat의 요청을 수신하기 시작했음을 의미합니다.
3단계: 게시 및 사용
앱 게시
사용 시나리오에 따라 다른 게시 방식을 선택할 수 있습니다:
| 게시 방식 | 적합한 시나리오 | 설명 |
|---|---|---|
| 특정 사용자 지정 | 테스트 단계 | 지정된 사용자에게만 표시 |
| 조직 내 게시 | 기업 내부 사용 | Workspace 도메인의 모든 사용자에게 표시 |
Google Cloud Console의 Chat API 설정 페이지에서 게시 범위를 설정하면, 대상 사용자가 Google Chat에서 해당 앱을 찾아 사용할 수 있습니다.
Google Chat에서 사용
- Google Chat을 엽니다
- 채팅 목록에서 Bot 이름을 검색합니다
- 1:1 대화를 시작하고 직접 질문을 입력합니다
- 채팅방에서 사용할 때는 @Bot으로 응답을 트리거합니다
멀티 채널 병렬 운영
OpenClaw의 멀티 채널 게이트웨이 아키텍처는 Google Chat이 다른 채널과 동시에 실행되는 것을 허용합니다. 예를 들어, Google Chat, Slack, Telegram을 동시에 활성화할 수 있으며, 모든 채널이 동일한 AI 모델 설정과 스킬 설정을 공유하면서 각자 독립적으로 메시지를 처리합니다.
이는 다음을 의미합니다:
- 서로 다른 채널의 대화 컨텍스트가 상호 격리됩니다
- 채널마다 다른 트리거 규칙을 설정할 수 있습니다
- 특정 채널에 문제가 발생해도 다른 채널의 정상 운영에 영향을 주지 않습니다
- 모든 채널이 OpenClaw 설정 파일 또는
openclaw channels login을 통해 통합 관리됩니다
문제 해결
Webhook 요청이 OpenClaw에 도달하지 않는 경우
- OpenClaw 서비스의 공인 HTTPS 주소가 정상적으로 접근 가능한지 확인합니다
- Google Cloud Console에 설정된 Webhook URL이 정확한지 확인합니다
- 방화벽이나 리버스 프록시가 관련 포트를 허용하는지 확인합니다
Bot이 Google Chat에서 보이지 않는 경우
- Google Chat API가 활성화되었는지 확인합니다
- 앱이 올바르게 게시되었는지 확인합니다(최소한 테스트 사용자에게 표시되어야 합니다)
- 개인 Gmail 계정이 아닌 Google Workspace 계정을 사용하고 있는지 확인합니다
요청 검증 실패
- 서비스 계정 키 파일 경로가 올바르고 파일이 손상되지 않았는지 확인합니다
- OpenClaw 설정의 프로젝트 ID가 Google Cloud 프로젝트와 일치하는지 확인합니다
# 상세 오류 로그 확인
openclaw logs --level error --component channel:google-chat
정리
OpenClaw을 Google Chat에 연결하는 핵심 단계:
- Google Cloud Console에서 Google Chat API를 활성화하고 HTTP Webhook 앱을 설정합니다
openclaw channels login을 통해 채널 설정을 완료합니다- 게시 범위를 설정하여 대상 사용자가 Bot을 찾아 사용할 수 있게 합니다
- 멀티 채널 게이트웨이를 활용하여 다른 채널과 동시에 운영합니다
Google Chat 통합은 네이티브 HTTP Webhook 모드를 사용하므로 설정이 비교적 간단합니다. 공인 HTTPS 주소가 접근 가능하고 서비스 계정 자격 증명이 올바르면 순조롭게 연동을 완료할 수 있습니다.