يثبّت 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
عنوان URL لـ 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 (12 ساعة)
تجديد مراقبة 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، مع استثناء واحد: تكون القيمة الافتراضية لـ --tailscale هي off مع run (وليست funnel) عندما لا تكون العلامة ولا hooks.gmail.tailscale.mode معيّنة.
