CLI commands

Webhook들

openclaw webhooks

Webhook 도우미 및 통합 기능입니다. 현재 이 기능 범위는 번들로 제공되는 gog 감시기를 기반으로 구축된 Gmail Pub/Sub 흐름으로 한정됩니다.

하위 명령

bash
openclaw webhooks gmail setup --account <email> [...]openclaw webhooks gmail run   [--account <email>] [...]
하위 명령 설명
gmail setup 일회성 마법사: Gmail 감시, Pub/Sub 주제/구독 및 OpenClaw 훅 전송을 설정합니다.
gmail run gog watch serve와 감시 자동 갱신 루프를 포그라운드에서 실행합니다.

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

gcloudgog가 없으면 설치하고, gcloud를 인증하며, Pub/Sub 주제와 구독을 생성하고, Gmail 감시를 시작한 다음 hooks.enabled=true와 함께 hooks.gmail 구성을 기록합니다. Next: openclaw webhooks gmail run을 출력합니다.

필수

플래그 설명
--account <email> 감시할 Gmail 계정입니다.

Pub/Sub 옵션

플래그 기본값 설명
--project <id> (없음) GCP 프로젝트 ID(OAuth 클라이언트 소유자)입니다. 주제 자체의 프로젝트 ID를 먼저 사용하고, 없으면 gog 자격 증명에서 확인된 프로젝트를 사용합니다.
--topic <name> gog-gmail-watch Pub/Sub 주제 이름입니다.
--subscription <name> gog-gmail-watch-push Pub/Sub 구독 이름입니다.
--label <label> INBOX 감시할 Gmail 라벨입니다.
--push-endpoint <url> (없음) 명시적인 Pub/Sub 푸시 엔드포인트입니다. Tailscale 설정보다 우선합니다.

OpenClaw 전송 옵션

플래그 기본값 설명
--hook-url <url> hooks.path와 Gateway 포트에서 생성 OpenClaw Webhook URL입니다.
--hook-token <token> hooks.token 또는 생성된 토큰 OpenClaw Webhook 토큰입니다.
--push-token <token> 생성된 토큰 gog watch serve에 전달되는 푸시 토큰입니다.

gog watch serve 옵션

플래그 기본값 설명
--bind <host> 127.0.0.1 gog watch serve 바인드 호스트입니다.
--port <port> 8788 gog watch serve 포트입니다.
--path <path> /gmail-pubsub gog watch serve 경로입니다. Tailscale이 명시적인 대상 없이 활성화된 경우 Tailscale이 프록시 처리 전에 경로를 제거하므로 /로 강제 설정됩니다.
--include-body true 이메일 본문 미리보기를 포함합니다. 이를 끄는 CLI 플래그는 없으며, 대신 구성에서 hooks.gmail.includeBody: false를 설정하세요.
--max-bytes <n> 20000 본문 미리보기 하나당 최대 바이트 수입니다.
--renew-minutes <n> 720 (12시간) N분마다 Gmail 감시를 갱신합니다.

Tailscale 공개

플래그 기본값 설명
--tailscale <mode> funnel Tailscale을 통해 푸시 엔드포인트를 공개합니다: funnel, serve 또는 off.
--tailscale-path <path> (없음) Tailscale serve/funnel의 경로입니다.
--tailscale-target <t> (없음) Tailscale serve/funnel 대상입니다(포트, host:port 또는 URL).

출력

플래그 설명
--json 텍스트 대신 머신 판독 가능한 요약을 출력합니다.

webhooks gmail run

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

gog watch serve와 감시 자동 갱신 루프를 포그라운드에서 실행하며, gog watch serve가 예기치 않게 종료되면 2초 후 다시 시작합니다.

run은 다음 예외를 제외하고 setup과 동일한 Pub/Sub, OpenClaw 전송, gog watch serve 및 Tailscale 플래그를 허용합니다.

  • run에서는 --account선택 사항이며, 지정하지 않으면 hooks.gmail.account를 사용합니다.
  • run--project, --push-endpoint 또는 --json을 허용하지 않습니다.
  • 모든 플래그는 일치하는 hooks.gmail.* 구성 값(setup에서 기록)을 먼저 사용한 다음, setup에서 사용하는 동일한 기본 제공 기본값을 사용합니다. 단, 한 가지 예외가 있습니다. 플래그와 hooks.gmail.tailscale.mode가 모두 설정되지 않은 경우 run에서 --tailscale의 기본값은 funnel이 아니라 off입니다.
범주 플래그
Pub/Sub --account, --topic, --subscription, --label
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

관련 문서

Was this useful?
On this page

On this page