Cómo conectar Google Chat a tu Gateway de OpenClaw

Configurar un bot que realmente funcione en tu espacio de trabajo suele ser un dolor de cabeza. Entre lidiar con permisos de Google Cloud y exponer endpoints de forma segura, es fácil perderse en la configuración antes de enviar el primer mensaje.

Si buscas una forma directa de interactuar con tu IA desde Google Chat sin complicaciones innecesarias, esta guía te muestra el camino más corto.

Requisitos previos

• Un proyecto en Google Cloud con la Google Chat API habilitada.
• Una Service Account con su respectiva JSON Key.
• Acceso al host de tu Gateway para almacenar credenciales.
• Una URL pública HTTPS (necesaria para recibir los webhooks de Google).

Inicio rápido

Configura tu integración en menos de 5 minutos siguiendo estos pasos:

1. Prepara las credenciales:
   • Ve a la consola de Google Cloud y crea una Service Account.
   • No necesitas asignar permisos ni roles específicos; puedes dejar esos campos en blanco.
   • En la pestaña Keys, selecciona Add Key > Create new key y descarga el archivo JSON.
2. Guarda la llave: Mueve el archivo JSON a tu servidor (por ejemplo, en ~/.openclaw/googlechat-service-account.json).
3. Configura la App en Google Chat:
   • En la consola de Google Cloud, activa las Interactive features.
   • Marca la opción Join spaces and group conversations.
   • En Connection settings, elige HTTP endpoint URL y pega la URL pública de tu Gateway terminada en /googlechat.
   • En Visibility, añade tu email para que solo tú puedas ver y usar la App.
4. Activa el estado: Tras guardar, refresca la página y cambia el App status a Live - available to users.
5. Configura OpenClaw:
   • Usa la variable de entorno: GOOGLE_CHAT_SERVICE_ACCOUNT_FILE=/ruta/al/archivo.json
   • O en tu archivo de configuración: channels.googlechat.serviceAccountFile: "/ruta/al/archivo.json".
6. Inicia el Gateway: Google Chat empezará a enviar peticiones POST a tu endpoint.

Para empezar a chatear, ve a Google Chat, haz clic en el icono + de Direct Messages y busca el nombre de tu App. Como es una App privada, no aparecerá en el Marketplace; tienes que buscarla por su nombre exacto.

Public URL (Solo Webhook)

Google Chat exige HTTPS. Lo mejor es exponer únicamente el path /googlechat y mantener el resto de tu infraestructura privada.

Opción recomendada: Tailscale Funnel

Esta es la mejor opción para mantener tu dashboard privado mientras expones el webhook.

1. Verifica el puerto:

   ss -tlnp | grep 18789

2. Expon el dashboard solo a tu red privada (port 8443):

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

3. Expon el webhook al público:

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

Opción alternativa: Caddy

Si prefieres usar Caddy como reverse proxy, usa esta configuración para redirigir solo el tráfico necesario:

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

Config highlights

Aquí tienes un ejemplo de cómo se ve la configuración en el archivo config.json5:

{
  channels: {
    googlechat: {
      enabled: true,
      serviceAccountFile: "/path/to/service-account.json",
      audienceType: "app-url",
      audience: "https://gateway.example.com/googlechat",
      webhookPath: "/googlechat",
      dm: {
        policy: "pairing",
        allowFrom: ["name@example.com"],
      },
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": {
          allow: true,
          requireMention: true,
        },
      },
    },
  },
}

Solución de problemas

Error 405 Method Not Allowed

Si ves este error en los logs de Google Cloud, significa que el Gateway no está procesando la ruta del webhook. Revisa estos puntos:

• Configuración faltante: Verifica que la sección channels.googlechat existe con openclaw config get channels.googlechat.
• Plugin desactivado: Asegúrate de que el plugin esté activo ejecutando openclaw plugins list | grep googlechat.
• Reinicio pendiente: Si hiciste cambios, aplica un openclaw gateway restart.
• Estado del canal: Ejecuta openclaw channels status para confirmar que aparece como enabled.

Si los mensajes no llegan, usa openclaw logs --follow mientras envías un mensaje de prueba para ver si la petición alcanza tu servidor.

¿Necesitas ayuda personalizada con tu configuración? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Gateway configuration
• Security