はじめに
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 アドレスが到達可能で、サービスアカウントの認証情報が正しければ、スムーズに連携を完了できます。