Canal Google Chat de OpenClaw
Conecte OpenClaw a Google Chat mediante un endpoint HTTP de la API de Google Chat. Esta integracion empresarial permite que su asistente de IA opere en Google Workspace — gestionando mensajes directos y conversaciones en espacios. El bot recibe solicitudes HTTP POST de Google Chat, valida bearer tokens a traves de una cuenta de servicio y enruta los mensajes a traves del Gateway de OpenClaw.
Google Chat Funciones compatibles
Mensajes de texto
Compatible
Medios y archivos
Compatible
Reacciones
Compatible
Hilos
Compatible
Mensajes de voz
No compatible
Chat grupal
Compatible
Google Chat Requisitos previos
- Una cuenta de Google Workspace (Business o Enterprise). El acceso de administrador del dominio puede ser necesario para aprobaciones de alcance y configuracion de visibilidad de la aplicacion
- Un proyecto de Google Cloud con la API de Google Chat habilitada
- Una cuenta de servicio con un archivo de clave JSON
- El Gateway de OpenClaw en ejecucion y configurado
- Un punto de acceso HTTPS accesible publicamente para el webhook (ej: Tailscale Funnel, Caddy o Cloudflare Tunnel)
Google Chat Configuración rápida
Habilitar la API de Google Chat y crear cuenta de servicio
Vaya a la Google Cloud Console, habilite la API de Google Chat. Cree una nueva cuenta de servicio (ej: 'openclaw-chat'), omita la configuracion de permisos, luego genere y descargue un archivo de clave JSON. Almacenelo en su host Gateway (ej: ~/.openclaw/googlechat-service-account.json).
Configurar la aplicacion Chat en Google Cloud Console
En la pagina de configuracion de Chat de Google Cloud Console, establezca el nombre de la aplicacion, la URL del avatar y la descripcion. Habilite las funciones interactivas, permita que la aplicacion se una a espacios y conversaciones de grupo. Seleccione 'URL de punto de acceso HTTP' como configuracion de conexion e ingrese la URL publica de su Gateway seguida de '/googlechat' (use 'openclaw status' para encontrar la URL del Gateway).
Establecer visibilidad, habilitar la aplicacion y probar
Restrinja la visibilidad de la aplicacion a usuarios o grupos especificos de su dominio. Guarde la configuracion, actualice la pagina y cambie el estado de la aplicacion a 'En vivo — disponible para usuarios'. En Google Chat, haga clic en el icono '+' junto a Mensajes directos, busque el nombre de su aplicacion y envie un mensaje de prueba.
Google Chat Ejemplo de configuración
{
"channels": {
"googlechat": {
"serviceAccountFile": "~/.openclaw/googlechat-service-account.json",
"webhookPath": "/googlechat"
}
}
}Google Chat Documentación Detallada
Descripcion general de la arquitectura
Configuracion de la cuenta de servicio
{
"channels": {
"googlechat": {
"serviceAccountFile": "~/.openclaw/googlechat-service-account.json"
}
}
}Configuracion de la aplicacion Chat
URL publica y configuracion de Webhook
# Ejemplo Tailscale Funnel:
tailscale funnel --set-path=/googlechat localhost:18789
# Ejemplo Caddy:
reverse_proxy /googlechat* localhost:18789
# Configuracion de ingreso Cloudflare Tunnel:
- hostname: your-domain.com
path: /googlechat
service: http://localhost:18789
- service: http_status:404Politicas de DM y grupo
{
"channels": {
"googlechat": {
"dmPolicy": "pairing",
"groupPolicy": "allowlist",
"groupAllowList": ["spaces/AAAA1234"]
}
}
}Destinos y enrutamiento de sesion
{
"channels": {
"googlechat": {
"botUser": "users/123456789",
"spaces": {
"spaces/AAAA1234": {
"systemPrompt": "Eres un asistente util para el equipo de ingenieria."
}
}
}
}
}Google Chat Referencia de Configuración
| Key | Type | Default | Description |
|---|---|---|---|
| serviceAccountFile | string | "" | Ruta al archivo de clave JSON de la cuenta de servicio de Google Cloud |
| audience | string | "app-url" | Tipo de audiencia para la validacion del bearer token. Opciones: app-url (usa token de identidad OIDC), project-number (usa token de acceso de cuenta de servicio) |
| audienceValue | string | "" | Valor de audiencia para la validacion del token (URL o numero de proyecto) |
| webhookPath | string | "/googlechat" | Ruta del punto de acceso HTTP para webhooks entrantes de Google Chat |
| botUser | string | "" | Identificador de usuario del bot (users/<id>) para deteccion de @menciones en espacios |
| dmPolicy | string | "pairing" | Controla quien puede enviar DMs al bot. Opciones: pairing, allowlist, open, disabled |
| allowFrom | string[] | [] | IDs de usuario o emails autorizados para enviar mensajes al bot (cuando dmPolicy es allowlist) |
| groupPolicy | string | "disabled" | Politica de espacios de grupo. Opciones: disabled, allowlist, open |
| groupAllowList | string[] | [] | IDs de espacio permitidos cuando groupPolicy es allowlist |
| spaces.<id>.systemPrompt | string | "" | Prompt de sistema IA personalizado para un espacio de Google Chat especifico |
| mediaMaxMb | number | 20 | Tamano maximo de archivos multimedia en megabytes |
| actions.typing | boolean | true | Enviar indicador de escritura mientras la IA genera una respuesta |
Ruta al archivo de clave JSON de la cuenta de servicio de Google Cloud
Tipo de audiencia para la validacion del bearer token. Opciones: app-url (usa token de identidad OIDC), project-number (usa token de acceso de cuenta de servicio)
Valor de audiencia para la validacion del token (URL o numero de proyecto)
Ruta del punto de acceso HTTP para webhooks entrantes de Google Chat
Identificador de usuario del bot (users/<id>) para deteccion de @menciones en espacios
Controla quien puede enviar DMs al bot. Opciones: pairing, allowlist, open, disabled
IDs de usuario o emails autorizados para enviar mensajes al bot (cuando dmPolicy es allowlist)
Politica de espacios de grupo. Opciones: disabled, allowlist, open
IDs de espacio permitidos cuando groupPolicy es allowlist
Prompt de sistema IA personalizado para un espacio de Google Chat especifico
Tamano maximo de archivos multimedia en megabytes
Enviar indicador de escritura mientras la IA genera una respuesta
Google Chat Preguntas Frecuentes
Google Chat Solución de Problemas
El plugin de Google Chat no esta habilitado, falta la seccion de configuracion channels.googlechat, o el Gateway no fue reiniciado despues de los cambios de configuracion.
La ruta del archivo de cuenta de servicio es incorrecta, la configuracion de audiencia no coincide, o el bearer token ha expirado.
El identificador de usuario del bot no esta configurado para la deteccion de @menciones, o el espacio no esta en la lista permitida.
La URL publica no esta correctamente configurada, el firewall bloquea conexiones entrantes, o el certificado SSL es invalido.