OpenClaw Google Chat Kanal

OpenClaw integriert sich ueber eine HTTP-Endpunkt-Architektur mit Google Chat. Der Ablauf ist wie folgt: 1. Google Chat sendet HTTP-POST-Anfragen mit 'Authorization: Bearer <token>'-Header an Ihren Gateway-Endpunkt. 2. OpenClaw validiert das Bearer-Token (ein von Google ausgestelltes OIDC-Identitaetstoken oder ein Dienstkonto-Zugriffstoken) gegen Ihre konfigurierten Zielgruppen-Einstellungen (app-url oder project-number). 3. Nachrichten werden ueber Session-Keys geroutet, die zwischen DMs und Spaces unterscheiden. 4. Standardmaessig verwenden DMs Pairing-Codes zur Zugriffskontrolle und Gruppen-Spaces @-Erwaehnung zur Aktivierung. Im Gegensatz zu WebSocket-basierten Kanaelen erfordert Google Chat einen oeffentlich zugaenglichen HTTPS-Endpunkt. Das Gateway lauscht auf eingehende HTTP-POST-Anfragen am konfigurierten Endpunkt-Pfad (Standard: /googlechat).

Fuer die Authentifizierung ist ein Google Cloud-Dienstkonto erforderlich. Folgen Sie diesen Schritten: 1. Gehen Sie zu Google Cloud Console → IAM & Verwaltung → Dienstkonten 2. Klicken Sie auf 'Dienstkonto erstellen' 3. Benennen Sie es (z.B. 'openclaw-chat') und ueberspringen Sie die optionale Berechtigungskonfiguration 4. Klicken Sie auf das erstellte Dienstkonto → Tab Schluessel → Schluessel hinzufuegen → Neuen Schluessel erstellen 5. Waehlen Sie das JSON-Format und laden Sie die Schluesseldatei herunter 6. Platzieren Sie die Datei an einem sicheren Ort auf Ihrem Gateway-Host (z.B. ~/.openclaw/googlechat-service-account.json) Die Dienstkonto-Anmeldedaten werden zur Validierung eingehender Webhook-Anfragen von Google Chat und zum Senden ausgehender Nachrichten ueber die Google Chat API verwendet.

{
  "channels": {
    "googlechat": {
      "serviceAccountFile": "~/.openclaw/googlechat-service-account.json"
    }
  }
}

Konfigurieren Sie die Chat-App in der Google Cloud Console: 1. Navigieren Sie zu Google Cloud Console → APIs & Dienste → Google Chat API → Konfiguration 2. Legen Sie App-Name, Avatar-URL und Beschreibung fest 3. Aktivieren Sie unter 'Interaktive Funktionen' die interaktiven Features 4. Erlauben Sie der App, Spaces und Gruppenkonversationen beizutreten 5. Waehlen Sie als Verbindungseinstellung 'HTTP-Endpunkt-URL' 6. Geben Sie die oeffentliche Webhook-URL Ihres Gateways ein (z.B. https://your-domain.com/googlechat) 7. Beschraenken Sie unter 'Sichtbarkeit' den Zugriff auf bestimmte Benutzer oder Gruppen in Ihrer Domain 8. Speichern Sie die Konfiguration, aktualisieren Sie die Seite und setzen Sie den App-Status auf 'Live — fuer Benutzer verfuegbar' Hinweis: Private Apps erscheinen nicht im Google Chat Marketplace. Benutzer muessen nach dem genauen App-Namen suchen, um sie zu finden und hinzuzufuegen.

Google Chat benoetigt einen oeffentlich zugaenglichen HTTPS-Endpunkt zum Senden von Webhook-Events. Drei Optionen werden empfohlen: Option A — Tailscale Funnel (empfohlen): • Gateway-Bind-Adresse pruefen: ss -tlnp | grep 18789 • Webhook oeffentlich freigeben: tailscale funnel --set-path=/googlechat localhost:18789 • Oeffentliche URL-Format: https://<node-name>.<tailnet>.ts.net/googlechat Option B — Caddy Reverse Proxy: • Nur den spezifischen Pfad proxyen: reverse_proxy /googlechat* localhost:18789 Option C — Cloudflare Tunnel: • Ingress-Regeln konfigurieren, um nur den /googlechat-Pfad an das Gateway weiterzuleiten, andere Anfragen erhalten 404. Unabhaengig von der gewaehlten Option muss die resultierende oeffentliche URL als HTTP-Endpunkt-URL in der Google Chat-App-Konfiguration eingegeben werden.

# Tailscale Funnel Beispiel:
tailscale funnel --set-path=/googlechat localhost:18789

# Caddy Beispiel:
reverse_proxy /googlechat* localhost:18789

# Cloudflare Tunnel Ingress-Konfiguration:
- hostname: your-domain.com
  path: /googlechat
  service: http://localhost:18789
- service: http_status:404

OpenClaw steuert den Zugriff auf Ihren Google Chat Bot ueber DM- und Gruppen-Richtlinien: DM-Richtlinie (Standard: pairing): • pairing — Neue Kontakte muessen einen Pairing-Prozess mit einem Code durchlaufen, den Sie ueber die CLI genehmigen • allowlist — Nur explizit aufgelistete Benutzer koennen dem Bot Nachrichten senden • open — Jeder kann dem Bot Nachrichten senden (mit Vorsicht verwenden) Gruppen-Richtlinie: • Standardmaessig antwortet der Bot nur bei @-Erwaehnungen in Gruppen-Spaces • Sie koennen eine Erlaubnisliste fuer bestimmte Spaces konfigurieren • Pro-Space-Konfiguration unterstuetzt benutzerdefinierte System-Prompts Die Zugriffskontrolle unterscheidet sich zwischen DMs und Spaces: DMs verwenden standardmaessig Pairing-Codes, Spaces verwenden @-Erwaehnungs-Aktivierung.

{
  "channels": {
    "googlechat": {
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "groupAllowList": ["spaces/AAAA1234"]
    }
  }
}

Google Chat-Ziele werden fuer ausgehende Nachrichten und Session-Identifikation verwendet: • Direktnachrichten: users/<userId> oder users/<email> • Spaces: spaces/<spaceId> Session-Keys unterscheiden zwischen DMs und Spaces und stellen sicher, dass jede Konversation einen eigenen isolierten Kontext hat. Der Bot-Benutzer-Bezeichner (botUser) wird fuer die @-Erwaehungserkennung in Gruppen-Spaces verwendet. Sie koennen auch einzelne Spaces mit benutzerdefinierten Einstellungen konfigurieren, einschliesslich System-Prompts und Zugriffskontrollen.

{
  "channels": {
    "googlechat": {
      "botUser": "users/123456789",
      "spaces": {
        "spaces/AAAA1234": {
          "systemPrompt": "Du bist ein hilfreicher Assistent fuer das Engineering-Team."
        }
      }
    }
  }
}