Instala gcloud y gog si no están presentes, autentica gcloud, crea el tema y la suscripción de Pub/Sub, inicia la observación de Gmail y escribe la configuración de hooks.gmail con hooks.enabled=true. Muestra Next: openclaw webhooks gmail run.
Obligatorio
Indicador
Descripción
--account <email>
Cuenta de Gmail que se observará.
Opciones de Pub/Sub
Indicador
Valor predeterminado
Descripción
--project <id>
(ninguno)
ID del proyecto de GCP (el propietario del cliente OAuth). Si no está disponible, se usa el ID del proyecto del propio tema y, después, el proyecto resuelto a partir de las credenciales de gog.
--topic <name>
gog-gmail-watch
Nombre del tema de Pub/Sub.
--subscription <name>
gog-gmail-watch-push
Nombre de la suscripción de Pub/Sub.
--label <label>
INBOX
Etiqueta de Gmail que se observará.
--push-endpoint <url>
(ninguno)
Endpoint push explícito de Pub/Sub. Anula Tailscale.
Opciones de entrega de OpenClaw
Indicador
Valor predeterminado
Descripción
--hook-url <url>
Creada a partir de hooks.path y el puerto del Gateway
URL del webhook de OpenClaw.
--hook-token <token>
hooks.token o un token generado
Token del webhook de OpenClaw.
--push-token <token>
Token generado
Token push reenviado a gog watch serve.
Opciones de gog watch serve
Indicador
Valor predeterminado
Descripción
--bind <host>
127.0.0.1
Host de enlace de gog watch serve.
--port <port>
8788
Puerto de gog watch serve.
--path <path>
/gmail-pubsub
Ruta de gog watch serve. Se fuerza a / cuando Tailscale está habilitado sin un destino explícito, ya que Tailscale elimina la ruta antes de pasarla por el proxy.
--include-body
true
Incluye fragmentos del cuerpo de los correos electrónicos. No existe ningún indicador de la CLI para desactivar esta opción; configure hooks.gmail.includeBody: false en la configuración.
--max-bytes <n>
20000
Máximo de bytes por fragmento del cuerpo.
--renew-minutes <n>
720 (12h)
Renueva la observación de Gmail cada N minutos.
Exposición mediante Tailscale
Indicador
Valor predeterminado
Descripción
--tailscale <mode>
funnel
Expone el endpoint push mediante tailscale: funnel, serve o off.
--tailscale-path <path>
(ninguno)
Ruta para tailscale serve/funnel.
--tailscale-target <t>
(ninguno)
Destino de Tailscale serve/funnel (puerto, host:port o URL).
Salida
Indicador
Descripción
--json
Muestra un resumen legible por máquina en lugar de texto.
webhooks gmail run
bash
openclaw webhooks gmail run --account you@example.com
Ejecuta gog watch serve junto con el bucle de renovación automática de la observación en primer plano y reinicia gog watch serve tras un retraso de 2s si termina inesperadamente.
run acepta los mismos indicadores de Pub/Sub, entrega de OpenClaw, gog watch serve y Tailscale que setup, excepto por lo siguiente:
--account es opcional en run; si no se especifica, se usa hooks.gmail.account.
runno acepta --project, --push-endpoint ni --json.
Cada indicador recurre al valor de configuración correspondiente de hooks.gmail.* (escrito por setup) y, después, al mismo valor predeterminado integrado que utiliza setup, con una excepción: --tailscale tiene como valor predeterminado off en run (no funnel) cuando no se han configurado ni el indicador ni hooks.gmail.tailscale.mode.
