`openclaw webhooks`

Ayudantes e integraciones de Webhook. Actualmente, esta superficie se limita a los flujos de Gmail Pub/Sub basados en el observador gog incluido.

Subcomandos

openclaw webhooks gmail setup --account <email> [...]
openclaw webhooks gmail run   [--account <email>] [...]

Subcomando	Descripción
`gmail setup`	Asistente de ejecución única: observación de Gmail, tema/suscripción de Pub/Sub y entrega al hook de OpenClaw.
`gmail run`	Ejecuta `gog watch serve` junto con el bucle de renovación automática de la observación en primer plano.

El Gateway también inicia automáticamente gog gmail watch serve durante el arranque una vez configurados hooks.enabled=true y hooks.gmail.account (los configura gmail setup). gmail run aplica la misma lógica en primer plano, lo que resulta útil para depurar o cuando el observador del Gateway está deshabilitado. Consulte Integración de Gmail Pub/Sub para conocer los detalles del inicio automático y la opción de exclusión OPENCLAW_SKIP_GMAIL_WATCHER.

`webhooks gmail setup`

openclaw webhooks gmail setup --account you@example.com
openclaw webhooks gmail setup --account you@example.com --project my-gcp-project --json
openclaw webhooks gmail setup --account you@example.com --hook-url https://gateway.example.com/hooks/gmail

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`

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.
run no 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.

Categoría	Indicadores
Pub/Sub	`--account`, `--topic`, `--subscription`, `--label`
Entrega de OpenClaw	`--hook-url`, `--hook-token`, `--push-token`
`gog watch serve`	`--bind`, `--port`, `--path`, `--include-body`, `--max-bytes`, `--renew-minutes`
Tailscale	`--tailscale`, `--tailscale-path`, `--tailscale-target`

Para run, el valor de --topic es la ruta completa del tema de Pub/Sub (projects/.../topics/...), no solo el nombre corto del tema.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Webhooks

`openclaw webhooks`

Subcomandos

`webhooks gmail setup`

Obligatorio

Opciones de Pub/Sub

Opciones de entrega de OpenClaw

Opciones de `gog watch serve`

Exposición mediante Tailscale

Salida

`webhooks gmail run`

Contenido relacionado

​openclaw webhooks

​Subcomandos

​webhooks gmail setup

​Obligatorio

​Opciones de Pub/Sub

​Opciones de entrega de OpenClaw

​Opciones de gog watch serve

​Exposición mediante Tailscale

​Salida

​webhooks gmail run

​Contenido relacionado

`openclaw webhooks`

Subcomandos

`webhooks gmail setup`

Obligatorio

Opciones de Pub/Sub

Opciones de entrega de OpenClaw

Opciones de `gog watch serve`

Exposición mediante Tailscale

Salida

`webhooks gmail run`

Contenido relacionado