Google Chat mit der Chat API integrieren

Du kennst das: Du hast ein nützliches Tool gebaut, aber die Integration in den täglichen Workflow scheitert an komplizierten Chat-APIs. Statt direkt loszulegen, kämpfst du mit Token-Validierungen und Firewall-Regeln, nur um eine einfache Nachricht zu empfangen.

Hier kommt die Google Chat API ins Spiel. Mit OpenClaw lässt sich das Ganze ziemlich schmerzfrei einrichten, damit dein Assistant direkt dort landet, wo dein Team kommuniziert.

Voraussetzungen

• Ein Google Cloud Projekt mit aktivierter Google Chat API
• Einen Service Account inklusive JSON Key
• Einen Gateway-Host, auf dem das JSON-File gespeichert wird
• Eine öffentliche HTTPS-URL für deinen Webhook

Schnellstart

In 5 Minuten ist dein Bot in Google Chat einsatzbereit. Folge einfach diesen Schritten:

1. Google Chat API aktivieren: Gehe in die Google Cloud Console und aktiviere die API für dein Projekt.
2. Service Account erstellen: Erstelle unter “Credentials” einen Service Account (z. B. openclaw-chat). Du musst hier keine speziellen Berechtigungen vergeben.
3. JSON Key herunterladen: Klicke auf den neu erstellten Service Account, gehe zum Tab Keys und erstelle einen neuen Key im JSON-Format.
4. Key speichern: Speichere die Datei auf deinem Gateway-Host (z. B. unter ~/.openclaw/googlechat-service-account.json).
5. Chat App konfigurieren: Gehe zur Google Chat Konfiguration in der Cloud Console.
   • Gib der App einen Namen und eine Avatar URL.
   • Aktiviere Interactive features.
   • Wähle unter Funktionalität Join spaces and group conversations.
   • Nutze als Connection Setting HTTP endpoint URL.
   • Setze die URL auf deine öffentliche Gateway-URL gefolgt von /googlechat.
6. Sichtbarkeit festlegen: Wähle unter “Visibility”, dass die App für bestimmte Personen in deiner Domain verfügbar ist, und trage deine E-Mail-Adresse ein.
7. App-Status auf Live setzen: Speichere, aktualisiere die Seite und ändere den App status auf Live - available to users. Speichere erneut.
8. OpenClaw konfigurieren: Setze den Pfad zum Service Account in deiner Konfiguration:
   • Env: GOOGLE_CHAT_SERVICE_ACCOUNT_FILE=/path/to/service-account.json
   • Oder config: channels.googlechat.serviceAccountFile: "/path/to/service-account.json"
9. Gateway starten: Starte das Gateway. Google Chat sendet nun POST-Requests an deinen Webhook-Pfad.

Public URL (Webhook-only)

Google Chat benötigt einen öffentlichen HTTPS-Endpunkt. Aus Sicherheitsgründen solltest du nur den Pfad /googlechat freigeben.

Option A: Tailscale Funnel (Empfohlen)

Mit Tailscale Serve bleibt dein Dashboard privat, während nur der Webhook-Pfad nach außen geöffnet wird.

1. Bind-Adresse prüfen:

   ss -tlnp | grep 18789

2. Dashboard privat freigeben (Port 8443):

   tailscale serve --bg --https 8443 http://127.0.0.1:18789

3. Webhook öffentlich freigeben:

   tailscale funnel --bg --set-path /googlechat http://127.0.0.1:18789/googlechat

4. Konfiguration prüfen:

   tailscale serve status
   tailscale funnel status

Option B: Reverse Proxy (Caddy)

Wenn du Caddy nutzt, leite gezielt nur den Webhook-Pfad weiter:

your-domain.com {
    reverse_proxy /googlechat* localhost:18789
}

Config Highlights

Hier ist ein Beispiel, wie die channels.googlechat Sektion in deiner Konfiguration aussehen kann:

{
  channels: {
    googlechat: {
      enabled: true,
      serviceAccountFile: "/path/to/service-account.json",
      audienceType: "app-url",
      audience: "https://gateway.example.com/googlechat",
      webhookPath: "/googlechat",
      botUser: "users/1234567890", // optional; hilft bei Mention-Erkennung
      dm: {
        policy: "pairing",
        allowFrom: ["users/1234567890", "name@example.com"],
      },
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": {
          allow: true,
          requireMention: true,
          users: ["users/1234567890"],
          systemPrompt: "Short answers only.",
        },
      },
      actions: { reactions: true },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

Fehlerbehebung

405 Method Not Allowed

Wenn du im Google Cloud Logs Explorer einen 405-Fehler siehst, ist der Webhook-Handler nicht registriert. Prüfe diese vier Punkte:

1. Channel-Konfiguration: Fehlt der channels.googlechat Bereich? Prüfe es mit openclaw config get channels.googlechat.
2. Plugin-Status: Ist das Plugin deaktiviert? Nutze openclaw plugins list | grep googlechat zum Checken.
3. Neustart vergessen: Hast du das Gateway nach der Konfigurationsänderung mit openclaw gateway restart neu gestartet?
4. Channel-Status: Was zeigt openclaw channels status an? Es sollte “enabled” und “configured” melden.

Andere Probleme

• Nutze openclaw channels status --probe für Details zu Auth-Fehlern.
• Wenn keine Nachrichten ankommen, kontrolliere die Webhook-URL in der Google Chat App Konfiguration.
• Prüfe mit openclaw logs --follow, ob Requests überhaupt dein Gateway erreichen.
• Falls Mentions in Gruppen ignoriert werden, stelle sicher, dass botUser korrekt gesetzt ist.

Hast du weitere Fragen? Nutze den AI Setup Assistant.

Nächste Schritte

• Gateway Konfiguration
• Security Guide
• Reactions Tool