Google Chat Setup

Connect OpenClaw to Google Workspace Chat

New to channel setup? For a hands-on tutorial, see Channel Setup Tutorial. This page covers Google Chat–specific setup.

OpenClaw connects to Google Chat via the Google Chat API using an HTTP webhook. Your assistant can handle DMs and participate in Chat spaces within Google Workspace. Good for teams already on Google Workspace who want the assistant in Chat alongside Gmail, Drive, and Meet.

Requirements: Google Workspace (Business or Enterprise), a Google Cloud project with billing, a publicly accessible HTTPS endpoint for the webhook, and domain admin access for Chat app authorization scopes.

Quick Setup

  1. Enable Google Chat API in Google Cloud Console
  2. Create a service account and download JSON key
  3. Configure a Chat app (HTTP endpoint: https://your-gateway/public-url/googlechat)
  4. Add service account path and webhook audience to OpenClaw config
  5. Set app to Live; search for it by name in Google Chat

Setup is moderately complex compared to Telegram or Discord—typically ~30 minutes. See docs.openclaw.ai/channels for full reference.

Prerequisites

  • Google Workspace — Business or Enterprise (Chat API is Workspace-only)
  • Google Cloud project — With billing enabled
  • Public HTTPS endpoint — Gateway reachable via Tailscale Funnel, Caddy, Cloudflare Tunnel, or similar
  • Domain admin — For Chat app scope approvals if required

DM Pairing

Google Chat uses the same DM pairing model as other channels: unknown senders receive a pairing code. Approve with openclaw pairing approve googlechat <code>. See Security guide for pairing and allowlists.

Supported Features

  • Text messages
  • Media and files
  • Reactions
  • Threads
  • Group chat (spaces)

Voice messages are not supported in Google Chat.

Related