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 [email protected]openclaw webhooks gmail setup --account [email protected] --project my-gcp-project --jsonopenclaw webhooks gmail setup --account [email protected] --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 [email protected]
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 統合を参照してください。
関連
