Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

openclaw webhooks

Funciones auxiliares e integraciones de Webhook. Actualmente, esta superficie se limita a los flujos de Gmail Pub/Sub que se integran con el watcher gog incluido.

Subcomandos

openclaw webhooks gmail setup --account <email> [...]
openclaw webhooks gmail run   [--account <email>] [...]
SubcomandoDescripción
gmail setupConfigura la vigilancia de Gmail, el tema/suscripción de Pub/Sub y el destino de entrega de Webhook de OpenClaw.
gmail runEjecuta gog watch serve más el bucle de renovación automática de la vigilancia.

webhooks gmail setup

Configura la vigilancia de Gmail, Pub/Sub y la entrega de Webhook de OpenClaw.
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

Obligatorio

FlagDescripción
--account <email>Cuenta de Gmail que vigilar.

Opciones de Pub/Sub

FlagValor predeterminadoDescripción
--project <id>(ninguno)ID de 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 que vigilar.
--push-endpoint <url>(ninguno)Endpoint push explícito de Pub/Sub. Anula Tailscale.

Opciones de entrega de OpenClaw

FlagValor predeterminadoDescripción
--hook-url <url>(ninguno)URL de Webhook de OpenClaw.
--hook-token <token>(ninguno)Token de Webhook de OpenClaw.
--push-token <token>(ninguno)Token push reenviado a gog watch serve.

Opciones de gog watch serve

FlagValor predeterminadoDescripció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-bodytrueIncluye fragmentos del cuerpo del correo. Pasa --no-include-body para desactivarlo.
--max-bytes <n>20000Máximo de bytes por fragmento de cuerpo.
--renew-minutes <n>720 (12h)Renueva la vigilancia de Gmail cada N minutos.

Exposición de Tailscale

FlagValor predeterminadoDescripción
--tailscale <mode>funnelExpone el endpoint push mediante Tailscale: funnel, serve u 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

FlagDescripción
--jsonImprime un resumen legible por máquina en lugar de texto.

webhooks gmail run

Ejecuta gog watch serve más el bucle de renovación automática de la vigilancia en primer plano.
openclaw webhooks gmail run --account you@example.com
run acepta los mismos flags de gog watch serve, entrega de OpenClaw, Pub/Sub y Tailscale que setup, excepto:
  • --account es opcional en run (recurre a la cuenta configurada).
  • run no acepta --project, --push-endpoint ni --json.
  • Los flags de run no tienen valores predeterminados integrados; los valores faltantes recurren a los valores escritos por setup.
CategoríaFlags
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.

Flujo de extremo a extremo

Consulta Integración de Gmail Pub/Sub para ver la configuración del proyecto de GCP, OAuth y del lado del Gateway que se combina con estos comandos de CLI.

Relacionado