OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Webhooks

openclaw webhooks

أدوات مساعدة وتكاملات Webhook. يقتصر هذا السطح حاليًا على تدفقات Gmail Pub/Sub المبنية على مراقب gog المضمّن.

الأوامر الفرعية

bash
openclaw webhooks gmail setup --account <email> [...]openclaw webhooks gmail run   [--account <email>] [...]
الأمر الفرعي الوصف
gmail setup معالج إعداد لمرة واحدة: مراقبة Gmail وموضوع Pub/Sub واشتراكه وتسليم خطاف OpenClaw.
gmail run تشغيل gog watch serve مع حلقة التجديد التلقائي للمراقبة في الواجهة الأمامية.

webhooks gmail setup

bash
openclaw 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

يثبّت 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 [email protected]

يشغّل 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 معيّنة.
الفئة العلامات
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

ذو صلة

Was this useful?
في هذه الصفحة

في هذه الصفحة