​

openclaw message

openclaw message <subcommand> [flags]

​

اختيار القناة

• يكون --channel <name> مطلوبًا إذا كانت هناك أكثر من قناة مُهيأة؛ وعند تهيئة قناة واحدة فقط، تكون تلك القناة هي الافتراضية.
• القيم: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (يتطلب Mattermost الـ Plugin).
• الأهداف المسبوقة باسم القناة (مثل discord:channel:123) تحدد الـ Plugin المالك دون الحاجة إلى تحديد --channel صراحةً.

​

تنسيقات الهدف (-t, --target)

​

العلامات الشائعة

​

تحليل SecretRef

• على نطاق القناة عند تعيين --channel (أو استنتاجه من هدف مسبوق باسم القناة)
• على نطاق الحساب عند تعيين --account أيضًا
• جميع القنوات المُهيأة عند عدم تعيين أي منهما

​

الإجراءات

​

الأساسية

​

الإرسال

openclaw message send --channel discord \
  --target channel:123 --message "hi" --reply-to 456

• --media <path-or-url>: إرفاق صورة/صوت/فيديو/مستند (مسار محلي أو URL).
• --presentation <json>: حمولة مشتركة تحتوي على كتل text وcontext وdivider وchart وtable وbuttons وselect، وتُعرض وفق إمكانات كل قناة. راجع عرض الرسائل.
• --delivery <json>: تفضيلات تسليم عامة، مثل {"pin": true}. يُعد --pin اختصارًا للتسليم المثبّت عندما تدعمه القناة.
• --reply-to <id> و--thread-id <id> (موضوع منتدى Telegram؛ الطابع الزمني لسلسلة Slack، وهو الحقل نفسه المستخدم في --reply-to).
• --force-document ‏(Telegram وWhatsApp): إرسال الصور وملفات GIF ومقاطع الفيديو كمستندات لتجنب ضغط القناة.
• --silent ‏(Telegram وDiscord): الإرسال دون إشعار.
• --gif-playback ‏(WhatsApp فقط): معاملة وسائط الفيديو كتشغيل GIF.

openclaw message send --channel discord \
  --target channel:123 --message "Choose:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Approve","value":"approve","style":"success"},{"label":"Decline","value":"decline","style":"danger"}]}]}'

openclaw message send --channel telegram --target @mychat --message "Choose:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Yes","value":"cmd:yes"},{"label":"No","value":"cmd:no"}]}]}'

openclaw message send --channel slack --target channel:C123 \
  --presentation '{"blocks":[{"type":"chart","chartType":"bar","title":"Quarterly revenue","categories":["Q1","Q2"],"series":[{"name":"Revenue","values":[120,145]}],"xLabel":"Quarter"}]}'

openclaw message send --channel slack --target channel:C123 \
  --presentation '{"title":"Pipeline report","blocks":[{"type":"table","caption":"Open pipeline","headers":["Account","Stage","ARR"],"rows":[["Acme","Won",125000],["Globex","Review",82000]],"rowHeaderColumnIndex":0}]}'

openclaw message send --channel telegram --target 123456789 --message "Open app:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Launch","webApp":{"url":"https://example.com/app"}}]}]}'

openclaw message send --channel telegram --target @mychat \
  --media ./diagram.png --force-document

openclaw message send --channel msteams \
  --target conversation:19:abc@thread.tacv2 \
  --presentation '{"title":"Status update","blocks":[{"type":"text","text":"Build completed"}]}'

​

استطلاع رأي

openclaw message poll --channel discord \
  --target channel:123 \
  --poll-question "Snack?" \
  --poll-option Pizza --poll-option Sushi \
  --poll-multi --poll-duration-hours 48

• --poll-option <choice>: كرّره من مرتين إلى 12 مرة.
• --poll-multi: يسمح باختيارات متعددة.
• Discord: ‏--poll-duration-hours، و--silent، و--message.
• Telegram: ‏--poll-duration-seconds <n> ‏(5-600)، و--silent، و--poll-anonymous / --poll-public، و--thread-id.

openclaw message poll --channel telegram \
  --target @mychat \
  --poll-question "Lunch?" \
  --poll-option Pizza --poll-option Sushi \
  --poll-duration-seconds 120 --silent

openclaw message poll --channel msteams \
  --target conversation:19:abc@thread.tacv2 \
  --poll-question "Lunch?" \
  --poll-option Pizza --poll-option Sushi

​

سلاسل المحادثات

• thread create: لقنوات Discord. المطلوب: --thread-name، و--target (معرّف القناة). اختياري: --message-id، و--message، و--auto-archive-min.
• thread list: لقنوات Discord. المطلوب: --guild-id. اختياري: --channel-id، و--include-archived، و--before، و--limit.
• thread reply: لقنوات Discord. المطلوب: --target (معرّف سلسلة المحادثة)، و--message. اختياري: --media، و--reply-to.

​

الرموز التعبيرية

• emoji list: ‏Discord ‏(--guild-id)، وSlack (من دون خيارات إضافية).
• emoji upload: ‏Discord. المطلوب: --guild-id، و--emoji-name، و--media. اختياري: --role-ids (قابل للتكرار).

​

الملصقات

• sticker send: ‏Discord. المطلوب: --target، و--sticker-id (قابل للتكرار). اختياري: --message.
• sticker upload: ‏Discord. المطلوب: --guild-id، و--sticker-name، و--sticker-desc، و--sticker-tags، و--media.

​

الأدوار والقنوات والصوت والأحداث (Discord)

• role info: ‏--guild-id.
• role add / role remove: ‏--guild-id، و--user-id، و--role-id.
• channel info: ‏--target.
• channel list: ‏--guild-id.
• voice status: ‏--guild-id، و--user-id.
• event list: ‏--guild-id.
• event create: المطلوب --guild-id، و--event-name، و--start-time؛ والاختياري --end-time، و--desc، و--channel-id، و--location، و--event-type، و--image <url-or-path>.

​

الإشراف (Discord)

• timeout: ‏--guild-id، و--user-id؛ واختياريًا --duration-min أو --until (احذف كليهما لإلغاء المهلة)، و--reason.
• kick: ‏--guild-id، و--user-id، و--reason.
• ban: ‏--guild-id، و--user-id، و--delete-days، و--reason.

​

البث

openclaw message broadcast --targets <target...> [--channel all] [--message <text>] [--media <url>] [--dry-run]

​

ذو صلة

• مرجع CLI
• إرسال الوكيل
• عرض الرسائل