Ir al contenido

Webhooks

Asistentes e integraciones de webhooks. Actualmente, esta superficie está limitada a los flujos de Gmail Pub/Sub que se integran con el observador gog incluido.

Ventana de terminal
openclaw webhooks gmail setup --account <email> [...]
openclaw webhooks gmail run [--account <email>] [...]
SubcomandoDescripción
gmail setupConfigure la observación de Gmail, el tema/suscripción de Pub/Sub y el destino de entrega del webhook de OpenClaw.
gmail runEjecute gog watch serve además del bucle de renovación automática de la observación.

Configure la observación de Gmail, Pub/Sub y la entrega del webhook de OpenClaw.

Ventana de terminal
openclaw webhooks gmail setup --account [email protected]
openclaw webhooks gmail setup --account [email protected] --project my-gcp-project --json
openclaw webhooks gmail setup --account [email protected] --hook-url https://gateway.example.com/hooks/gmail
OpciónDescripción
--account <email>Cuenta de Gmail a observar.
OpciónPredeterminadoDescripción
--project <id>(ninguno)ID del proyecto de GCP (el propietario del cliente OAuth).
--topic <name>gog-gmail-watchNombre del tema de Pub/Sub.
--subscription <name>gog-gmail-watch-pushNombre de la suscripción de Pub/Sub.
--label <label>INBOXEtiqueta de Gmail a observar.
--push-endpoint <url>(ninguno)Endpoint de push explícito de Pub/Sub. Anula Tailscale.
OpciónPredeterminadoDescripción
--hook-url <url>(ninguno)URL del webhook de OpenClaw.
--hook-token <token>(ninguno)Token del webhook de OpenClaw.
--push-token <token>(ninguno)Token de push reenviado a gog watch serve.
OpciónPredeterminadoDescripción
--bind <host>127.0.0.1Host de enlace de gog watch serve.
--port <port>8788Puerto de gog watch serve.
--path <path>/gmail-pubsubRuta de gog watch serve.
--include-bodytrueIncluir fragmentos del cuerpo del correo electrónico. Pase --no-include-body para desactivar.
--max-bytes <n>20000Máximo de bytes por fragmento del cuerpo.
--renew-minutes <n>720 (12h)Renovar la vigilancia de Gmail cada N minutos.
OpciónPredeterminadoDescripción
--tailscale <mode>funnelExponer el endpoint de push a través de tailscale: funnel, serve, o off.
--tailscale-path <path>(ninguno)Ruta para tailscale serve/funnel.
--tailscale-target <t>(ninguno)Objetivo de tailscale serve/funnel (puerto, host:port o URL).
OpciónDescripción
--jsonImprimir un resumen legible por máquina en lugar de texto.

Ejecutar gog watch serve más el bucle de renovación automática de vigilancia en primer plano.

Ventana de terminal
openclaw webhooks gmail run --account [email protected]

run acepta las mismas opciones de gog watch serve, entrega de OpenClaw, Pub/Sub y Tailscale que setup, excepto:

  • --account es opcional en run (se remite a la cuenta configurada).
  • run no acepta --project, --push-endpoint o --json.
  • Las opciones de run no tienen valores predeterminados integrados; los valores faltantes se remiten a los valores escritos por setup.
CategoríaOpciones
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

Consulte Integración de Gmail Pub/Sub para conocer la configuración del proyecto de GCP, OAuth y del lado de la puerta de enlace que se combina con estos comandos de CLI.