CLI commands

Webhooki

openclaw webhooks

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

Podpolecenia

bash
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.

webhooks gmail setup

bash
openclaw webhooks gmail setup --account you@example.comopenclaw webhooks gmail setup --account you@example.com --project my-gcp-project --jsonopenclaw 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

bash
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

Powiązane materiały

Was this useful?
On this page

On this page