Chuyển đến nội dung chính

openclaw webhooks

Các trình trợ giúp và tích hợp Webhook. Hiện tại bề mặt này được giới hạn cho các luồng Gmail Pub/Sub tích hợp với trình theo dõi gog đi kèm.

Lệnh con

openclaw webhooks gmail setup --account <email> [...]
openclaw webhooks gmail run   [--account <email>] [...]
Lệnh conMô tả
gmail setupCấu hình Gmail watch, chủ đề/gói đăng ký Pub/Sub và đích phân phối Webhook của OpenClaw.
gmail runChạy gog watch serve cùng với vòng lặp tự động gia hạn watch.

webhooks gmail setup

Cấu hình Gmail watch, Pub/Sub và phân phối Webhook của OpenClaw.
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

Bắt buộc

CờMô tả
--account <email>Tài khoản Gmail cần theo dõi.

Tùy chọn Pub/Sub

CờMặc địnhMô tả
--project <id>(không có)id dự án GCP (chủ sở hữu OAuth client).
--topic <name>gog-gmail-watchTên chủ đề Pub/Sub.
--subscription <name>gog-gmail-watch-pushTên gói đăng ký Pub/Sub.
--label <label>INBOXNhãn Gmail cần theo dõi.
--push-endpoint <url>(không có)Điểm cuối push Pub/Sub tường minh. Ghi đè Tailscale.

Tùy chọn phân phối OpenClaw

CờMặc địnhMô tả
--hook-url <url>(không có)URL Webhook của OpenClaw.
--hook-token <token>(không có)Token Webhook của OpenClaw.
--push-token <token>(không có)Token push được chuyển tiếp tới gog watch serve.

Tùy chọn gog watch serve

CờMặc địnhMô tả
--bind <host>127.0.0.1Máy chủ bind của gog watch serve.
--port <port>8788Cổng của gog watch serve.
--path <path>/gmail-pubsubĐường dẫn của gog watch serve.
--include-bodytrueBao gồm đoạn trích nội dung email. Truyền --no-include-body để tắt.
--max-bytes <n>20000Số byte tối đa cho mỗi đoạn trích nội dung.
--renew-minutes <n>720 (12h)Gia hạn Gmail watch mỗi N phút.

Phơi bày qua Tailscale

CờMặc địnhMô tả
--tailscale <mode>funnelPhơi bày điểm cuối push qua tailscale: funnel, serve hoặc off.
--tailscale-path <path>(không có)Đường dẫn cho tailscale serve/funnel.
--tailscale-target <t>(không có)Đích Tailscale serve/funnel (cổng, host:port hoặc URL).

Đầu ra

CờMô tả
--jsonIn bản tóm tắt máy có thể đọc thay vì văn bản.

webhooks gmail run

Chạy gog watch serve cùng với vòng lặp tự động gia hạn watch ở tiền cảnh.
openclaw webhooks gmail run --account you@example.com
run chấp nhận cùng các cờ gog watch serve, phân phối OpenClaw, Pub/Sub và Tailscale như setup, ngoại trừ:
  • --accounttùy chọn trên run (nó dự phòng về tài khoản đã cấu hình).
  • run không chấp nhận --project, --push-endpoint hoặc --json.
  • Các cờ của run không có mặc định tích hợp; giá trị bị thiếu sẽ dự phòng về các giá trị do setup ghi.
Danh mụcCờ
Pub/Sub--account, --topic, --subscription, --label
Phân phối 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
Đối với run, giá trị --topic là đường dẫn chủ đề Pub/Sub đầy đủ (projects/.../topics/...), không chỉ là tên chủ đề ngắn.

Luồng đầu cuối

Xem Tích hợp Gmail Pub/Sub để biết thiết lập dự án GCP, OAuth và phía Gateway ghép với các lệnh CLI này.

Liên quan