`openclaw webhooks`

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

하위 명령

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

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

hooks.enabled=true이고 hooks.gmail.account가 설정되어 있으면(gmail setup에서 설정) Gateway는 부팅 시 gog gmail watch serve도 자동으로 시작합니다. gmail run은 동일한 로직을 포그라운드에서 실행하며, 디버깅하거나 Gateway 감시기가 비활성화된 경우에 유용합니다. 자동 시작에 관한 자세한 내용과 OPENCLAW_SKIP_GMAIL_WATCHER 비활성화 옵션은 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

gcloud와 gog가 없으면 설치하고, 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`

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`

run에서 --topic 값은 짧은 주제 이름이 아니라 전체 Pub/Sub 주제 경로(projects/.../topics/...)입니다.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Webhook들

`openclaw webhooks`

하위 명령

`webhooks gmail setup`

필수

Pub/Sub 옵션

OpenClaw 전송 옵션

`gog watch serve` 옵션

Tailscale 공개

출력

`webhooks gmail run`

관련 문서

​openclaw webhooks

​하위 명령

​webhooks gmail setup

​필수

​Pub/Sub 옵션

​OpenClaw 전송 옵션

​gog watch serve 옵션

​Tailscale 공개

​출력

​webhooks gmail run

​관련 문서

`openclaw webhooks`

하위 명령

`webhooks gmail setup`

필수

Pub/Sub 옵션

OpenClaw 전송 옵션

`gog watch serve` 옵션

Tailscale 공개

출력

`webhooks gmail run`

관련 문서