Instala gcloud e gog caso estejam ausentes, autentica o gcloud, cria o tópico e a assinatura Pub/Sub, inicia a observação do Gmail e grava a configuração hooks.gmail com hooks.enabled=true. Exibe Próximo: openclaw webhooks gmail run.
Obrigatório
Opção
Descrição
--account <email>
Conta do Gmail a ser observada.
Opções do Pub/Sub
Opção
Padrão
Descrição
--project <id>
(nenhum)
ID do projeto do GCP (o proprietário do cliente OAuth). Como alternativas, usa o ID do projeto do próprio tópico e, depois, o projeto determinado pelas credenciais do gog.
--topic <name>
gog-gmail-watch
Nome do tópico Pub/Sub.
--subscription <name>
gog-gmail-watch-push
Nome da assinatura Pub/Sub.
--label <label>
INBOX
Marcador do Gmail a ser observado.
--push-endpoint <url>
(nenhum)
Endpoint push explícito do Pub/Sub. Substitui o Tailscale.
Opções de entrega do OpenClaw
Opção
Padrão
Descrição
--hook-url <url>
Criada com hooks.path e a porta do Gateway
URL do Webhook do OpenClaw.
--hook-token <token>
hooks.token ou um token gerado
Token do Webhook do OpenClaw.
--push-token <token>
Token gerado
Token push encaminhado ao gog watch serve.
Opções do gog watch serve
Opção
Padrão
Descrição
--bind <host>
127.0.0.1
Host de vinculação do gog watch serve.
--port <port>
8788
Porta do gog watch serve.
--path <path>
/gmail-pubsub
Caminho do gog watch serve. Forçado para / quando o Tailscale está ativado sem um destino explícito, pois o Tailscale remove o caminho antes de encaminhar pelo proxy.
--include-body
true
Inclui trechos do corpo do e-mail. Não há uma opção da CLI para desativar isso; em vez disso, defina hooks.gmail.includeBody: false na configuração.
--max-bytes <n>
20000
Número máximo de bytes por trecho do corpo.
--renew-minutes <n>
720 (12h)
Renova a observação do Gmail a cada N minutos.
Exposição pelo Tailscale
Opção
Padrão
Descrição
--tailscale <mode>
funnel
Expõe o endpoint push pelo Tailscale: funnel, serve ou off.
--tailscale-path <path>
(nenhum)
Caminho para o serve/funnel do Tailscale.
--tailscale-target <t>
(nenhum)
Destino do serve/funnel do Tailscale (porta, host:port ou URL).
Saída
Opção
Descrição
--json
Exibe um resumo legível por máquina em vez de texto.
webhooks gmail run
bash
openclaw webhooks gmail run --account you@example.com
Executa gog watch serve junto com o ciclo de renovação automática da observação em primeiro plano, reiniciando gog watch serve após um atraso de 2s caso ele seja encerrado inesperadamente.
run aceita as mesmas opções do Pub/Sub, de entrega do OpenClaw, do gog watch serve e do Tailscale que setup, exceto:
--account é opcional em run; como alternativa, usa hooks.gmail.account.
runnão aceita --project, --push-endpoint nem --json.
Cada opção usa como alternativa o valor correspondente da configuração hooks.gmail.* (gravado por setup) e, depois, o mesmo padrão interno usado por setup, com uma exceção: --tailscale usa off como padrão em run (não funnel) quando nem a opção nem hooks.gmail.tailscale.mode estão definidos.
