`openclaw webhooks`

Narzędzia pomocnicze i integracje Webhook. Obecnie ten obszar obejmuje przepływy Gmail Pub/Sub oparte na dołączonym obserwatorze gog.

Podpolecenia

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

Podpolecenie	Opis
`gmail setup`	Jednorazowy kreator: obserwowanie Gmaila, temat i subskrypcja Pub/Sub oraz dostarczanie do haka OpenClaw.
`gmail run`	Uruchamia `gog watch serve` wraz z pętlą automatycznego odnawiania obserwowania na pierwszym planie.

Gateway automatycznie uruchamia również gog gmail watch serve podczas startu, gdy ustawiono hooks.enabled=true oraz hooks.gmail.account (ustawiane przez gmail setup). gmail run realizuje tę samą logikę na pierwszym planie, co jest przydatne podczas debugowania lub gdy obserwator Gateway jest wyłączony. Szczegóły automatycznego uruchamiania oraz sposób rezygnacji za pomocą OPENCLAW_SKIP_GMAIL_WATCHER opisano w sekcji Integracja Gmail Pub/Sub.

`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

Instaluje gcloud i gog, jeśli ich brakuje, uwierzytelnia gcloud, tworzy temat i subskrypcję Pub/Sub, rozpoczyna obserwowanie Gmaila oraz zapisuje konfigurację hooks.gmail z wartością hooks.enabled=true. Wyświetla Next: openclaw webhooks gmail run.

Wymagane

Flaga	Opis
`--account <email>`	Konto Gmail, które ma być obserwowane.

Opcje Pub/Sub

Flaga	Wartość domyślna	Opis
`--project <id>`	(brak)	Identyfikator projektu GCP (właściciela klienta OAuth). W razie braku używany jest identyfikator projektu tematu, a następnie projekt określony na podstawie danych uwierzytelniających `gog`.
`--topic <name>`	`gog-gmail-watch`	Nazwa tematu Pub/Sub.
`--subscription <name>`	`gog-gmail-watch-push`	Nazwa subskrypcji Pub/Sub.
`--label <label>`	`INBOX`	Etykieta Gmaila, która ma być obserwowana.
`--push-endpoint <url>`	(brak)	Jawnie określony punkt końcowy push Pub/Sub. Zastępuje Tailscale.

Opcje dostarczania OpenClaw

Flaga	Wartość domyślna	Opis
`--hook-url <url>`	Tworzony na podstawie `hooks.path` i portu Gateway	Adres URL Webhook OpenClaw.
`--hook-token <token>`	`hooks.token` lub wygenerowany token	Token Webhook OpenClaw.
`--push-token <token>`	Wygenerowany token	Token push przekazywany do `gog watch serve`.

Opcje `gog watch serve`

Flaga	Wartość domyślna	Opis
`--bind <host>`	`127.0.0.1`	Host powiązania `gog watch serve`.
`--port <port>`	`8788`	Port `gog watch serve`.
`--path <path>`	`/gmail-pubsub`	Ścieżka `gog watch serve`. Wymuszana jest wartość `/`, gdy Tailscale jest włączony bez jawnie określonego celu, ponieważ Tailscale usuwa ścieżkę przed przekazaniem przez serwer proxy.
`--include-body`	`true`	Dołącza fragmenty treści wiadomości e-mail. Nie ma flagi CLI umożliwiającej wyłączenie tej opcji; zamiast tego ustaw w konfiguracji `hooks.gmail.includeBody: false`.
`--max-bytes <n>`	`20000`	Maksymalna liczba bajtów na fragment treści.
`--renew-minutes <n>`	`720` (12 godz.)	Odnawia obserwowanie Gmaila co N minut.

Udostępnianie przez Tailscale

Flaga	Wartość domyślna	Opis
`--tailscale <mode>`	`funnel`	Udostępnia punkt końcowy push przez Tailscale: `funnel`, `serve` lub `off`.
`--tailscale-path <path>`	(brak)	Ścieżka dla funkcji serve/funnel Tailscale.
`--tailscale-target <t>`	(brak)	Cel funkcji serve/funnel Tailscale (port, `host:port` lub adres URL).

Dane wyjściowe

Flaga	Opis
`--json`	Wyświetla podsumowanie do odczytu maszynowego zamiast tekstu.

`webhooks gmail run`

openclaw webhooks gmail run --account you@example.com

Uruchamia gog watch serve wraz z pętlą automatycznego odnawiania obserwowania na pierwszym planie, ponownie uruchamiając gog watch serve po 2-sekundowym opóźnieniu, jeśli proces nieoczekiwanie się zakończy. run przyjmuje te same flagi Pub/Sub, dostarczania OpenClaw, gog watch serve i Tailscale co setup, z następującymi wyjątkami:

Flaga --account jest opcjonalna dla run; w razie jej braku używana jest wartość hooks.gmail.account.
run nie przyjmuje flag --project, --push-endpoint ani --json.
Każda flaga używa w razie braku odpowiadającej jej wartości konfiguracji hooks.gmail.* (zapisanej przez setup), a następnie tej samej wbudowanej wartości domyślnej, której używa setup, z jednym wyjątkiem: dla run wartością domyślną --tailscale jest off (a nie funnel), gdy nie ustawiono ani flagi, ani hooks.gmail.tailscale.mode.

Kategoria	Flagi
Pub/Sub	`--account`, `--topic`, `--subscription`, `--label`
Dostarczanie 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`

Dla run wartość --topic jest pełną ścieżką tematu Pub/Sub (projects/.../topics/...), a nie tylko skróconą nazwą tematu.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Webhooki

`openclaw webhooks`

Podpolecenia

`webhooks gmail setup`

Wymagane

Opcje Pub/Sub

Opcje dostarczania OpenClaw

Opcje `gog watch serve`

Udostępnianie przez Tailscale

Dane wyjściowe

`webhooks gmail run`

Powiązane materiały

​openclaw webhooks

​Podpolecenia

​webhooks gmail setup

​Wymagane

​Opcje Pub/Sub

​Opcje dostarczania OpenClaw

​Opcje gog watch serve

​Udostępnianie przez Tailscale

​Dane wyjściowe

​webhooks gmail run

​Powiązane materiały

`openclaw webhooks`

Podpolecenia

`webhooks gmail setup`

Wymagane

Opcje Pub/Sub

Opcje dostarczania OpenClaw

Opcje `gog watch serve`

Udostępnianie przez Tailscale

Dane wyjściowe

`webhooks gmail run`

Powiązane materiały