CLI commands
Webhook
openclaw webhooks
Webhook 헬퍼 및 통합. 현재 이 인터페이스는 번들된 gog 감시기와 통합되는 Gmail Pub/Sub 흐름으로 범위가 지정되어 있습니다.
하위 명령
bashopenclaw webhooks gmail setup --account <email> [...]openclaw webhooks gmail run [--account <email>] [...]
| 하위 명령 |
설명 |
gmail setup |
Gmail watch, Pub/Sub 주제/구독, OpenClaw Webhook 전달 대상을 구성합니다. |
gmail run |
gog watch serve와 watch 자동 갱신 루프를 실행합니다. |
webhooks gmail setup
Gmail watch, Pub/Sub, OpenClaw Webhook 전달을 구성합니다.
bashopenclaw 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
필수
| 플래그 |
설명 |
--account <email> |
감시할 Gmail 계정입니다. |
Pub/Sub 옵션
| 플래그 |
기본값 |
설명 |
--project <id> |
(없음) |
GCP 프로젝트 id(OAuth 클라이언트 소유자)입니다. |
--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> |
(없음) |
OpenClaw Webhook URL입니다. |
--hook-token <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 경로입니다. |
--include-body |
true |
이메일 본문 스니펫을 포함합니다. 비활성화하려면 --no-include-body를 전달하세요. |
--max-bytes <n> |
20000 |
본문 스니펫당 최대 바이트 수입니다. |
--renew-minutes <n> |
720 (12h) |
N분마다 Gmail watch를 갱신합니다. |
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
gog watch serve와 watch 자동 갱신 루프를 포그라운드에서 실행합니다.
bashopenclaw webhooks gmail run --account you@example.com
run은 setup과 동일한 gog watch serve, OpenClaw 전달, Pub/Sub, Tailscale 플래그를 허용하지만 다음은 예외입니다.
--account는 run에서 선택 사항입니다(구성된 계정으로 대체됩니다).run은 --project, --push-endpoint 또는 --json을 허용하지 않습니다.run 플래그에는 내장 기본값이 없습니다. 누락된 값은 setup이 작성한 값으로 대체됩니다.
| 범주 |
플래그 |
| 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 |
엔드 투 엔드 흐름
이러한 CLI 명령과 함께 사용하는 GCP 프로젝트, OAuth, Gateway 측 설정은 Gmail Pub/Sub 통합을 참조하세요.
관련
