🦞
Channel Integration

Connect OpenClaw to Google Chat

Integrate OpenClaw with Google Workspace for AI-powered assistance directly in Google Chat.

📧 Why Use Google Chat?
  • ✓Google Workspace Integration — Seamless with Gmail, Drive, Calendar
  • ✓Enterprise Security — Built-in Google security and compliance
  • ✓Spaces Support — Collaborate with teams in dedicated spaces
  • ✓Rich Cards — Interactive cards and dialogs
  • ✓Mobile Apps — Native iOS and Android apps

Setup Steps

1

Create a Google Cloud Project

Set up a Google Cloud project for your Chat app:

  • • Go to Google Cloud Console
  • • Create a new project or select an existing one
  • • Enable the Google Chat API
2

Configure the Chat App

Set up your Chat app in Google Cloud Console:

  • • Go to APIs & Services → Google Chat API → Configuration
  • • Set the app name (e.g., "OpenClaw")
  • • Set the avatar URL and description
  • • Choose "App URL" as the connection setting
  • • Enter your OpenClaw webhook URL
3

Create Service Account Credentials

Generate credentials for OpenClaw to authenticate:

  • • Go to APIs & Services → Credentials
  • • Create a Service Account
  • • Download the JSON key file
  • • Store the key file securely
4

Configure OpenClaw

Add the Google Chat configuration to your openclaw.json:

{
  "channels": {
    "googleChat": {
      "enabled": true,
      "credentialsPath": "/path/to/service-account.json",
      "projectId": "YOUR_PROJECT_ID",
      "allowFrom": ["user@yourdomain.com"]
    }
  }
}
5

Publish and Test

Publish your app and start chatting:

  • • In Google Cloud Console, publish the app to your organization
  • • Restart OpenClaw: openclaw restart
  • • In Google Chat, search for your app and start a conversation
Advanced Configuration
{
  "channels": {
    "googleChat": {
      "enabled": true,
      "credentialsPath": "/path/to/service-account.json",
      "projectId": "YOUR_PROJECT_ID",
      "allowFrom": ["user1@domain.com", "user2@domain.com"],
      "allowSpaces": ["spaces/SPACE_ID"],
      "respondToMentions": true,
      "respondToDMs": true,
      "useCards": true,
      "webhookUrl": "https://your-server.com/webhook/google-chat"
    }
  }
}
  • credentialsPath — Path to service account JSON key
  • allowSpaces — Restrict bot to specific spaces
  • useCards — Enable rich card formatting
  • webhookUrl — Your server's webhook endpoint
Features
  • ✓Google Workspace Integration — Works with Gmail, Drive, Calendar, Meet
  • ✓Spaces & DMs — Works in group spaces and direct messages
  • ✓Rich Cards — Interactive cards with buttons and forms
  • ✓Slash Commands — Custom commands for quick actions
  • ✓File Sharing — Share files directly from Google Drive
⚠️ Troubleshooting

App not appearing in Google Chat?

Ensure the app is published and your Google Workspace admin has approved it.

Authentication errors?

Verify the service account JSON file is correct and has the necessary permissions.

Webhook not receiving messages?

Check that your webhook URL is publicly accessible and HTTPS-enabled.

For more detailed configuration options and advanced features, visit the official documentation:

docs.openclaw.ai/channels/google-chat →

Google Chat Connected!

Now configure more channels or enhance your bot with custom skills.

Add SlackExplore Skills