اگر gcloud و gog موجود نباشند، آنها را نصب میکند، احراز هویت gcloud را انجام میدهد، موضوع و اشتراک Pub/Sub را ایجاد میکند، پایش Gmail را آغاز میکند و پیکربندی hooks.gmail را با hooks.enabled=true مینویسد. سپس Next: openclaw webhooks gmail run را نمایش میدهد.
الزامی
پرچم
توضیحات
--account <email>
حساب Gmail موردنظر برای پایش.
گزینههای Pub/Sub
پرچم
پیشفرض
توضیحات
--project <id>
(هیچکدام)
شناسهٔ پروژهٔ GCP (مالک کلاینت OAuth). در صورت نبود، ابتدا از شناسهٔ پروژهٔ خود موضوع و سپس از پروژهٔ استخراجشده از اطلاعات احراز هویت 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
نشانی Webhook در OpenClaw.
--hook-token <token>
hooks.token یا یک توکن تولیدشده
توکن Webhook در OpenClaw.
--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 (۱۲ ساعت)
پایش Gmail را هر N دقیقه تمدید میکند.
دسترسی از طریق Tailscale
پرچم
پیشفرض
توضیحات
--tailscale <mode>
funnel
نقطهٔ پایانی ارسال را از طریق Tailscale در معرض دسترسی قرار میدهد: funnel، serve یا off.
--tailscale-path <path>
(هیچکدام)
مسیر برای سرویسدهی/تونل Tailscale.
--tailscale-target <t>
(هیچکدام)
مقصد سرویسدهی/تونل Tailscale (درگاه، host:port یا URL).
خروجی
پرچم
توضیحات
--json
بهجای متن، خلاصهای قابلخواندن برای ماشین چاپ میکند.
webhooks gmail run
bash
openclaw webhooks gmail run --account you@example.com
gog watch serve را بههمراه حلقهٔ تمدید خودکار پایش در پیشزمینه اجرا میکند و اگر gog watch serve بهطور غیرمنتظره خارج شود، پس از ۲ ثانیه آن را دوباره راهاندازی میکند.
run همان پرچمهای Pub/Sub، تحویل OpenClaw، gog watch serve و Tailscale در setup را میپذیرد، بهجز موارد زیر:
--account در runاختیاری است؛ در صورت نبود، از hooks.gmail.account استفاده میشود.
run پرچمهای --project، --push-endpoint یا --json را نمیپذیرد.
هر پرچم ابتدا از مقدار پیکربندی متناظر hooks.gmail.* (نوشتهشده توسط setup) و سپس از همان پیشفرض داخلی مورد استفادهٔ setup استفاده میکند، با یک استثنا: اگر نه پرچم و نه hooks.gmail.tailscale.mode تنظیم شده باشند، مقدار پیشفرض --tailscale در run برابر off است، نه funnel.
