openclaw message

فرمان خروجی واحد برای ارسال پیام‌ها و کنش‌های کانال (Discord/Google Chat/iMessage/Matrix/Mattermost (Plugin)/Microsoft Teams/Signal/Slack/Telegram/WhatsApp).

استفاده

openclaw message <subcommand> [flags]

انتخاب کانال:

• اگر بیش از یک کانال پیکربندی شده باشد، --channel الزامی است.
• اگر دقیقا یک کانال پیکربندی شده باشد، همان پیش‌فرض می‌شود.
• مقدارها: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost به Plugin نیاز دارد)
• وقتی --channel یا یک مقصد دارای پیشوند کانال وجود داشته باشد، openclaw message کانال انتخاب‌شده را به Plugin مالک آن نگاشت می‌کند؛ در غیر این صورت، Pluginهای کانال پیکربندی‌شده را برای استنباط کانال پیش‌فرض بارگذاری می‌کند.

قالب‌های مقصد (--target):

• WhatsApp: E.164، JID گروه، یا JID کانال/خبرنامه WhatsApp (...@newsletter)
• Telegram: شناسه چت، @username، یا مقصد موضوع انجمن (-1001234567890:topic:42، یا --thread-id 42)
• Discord: channel:<id> یا user:<id> (یا منشن <@id>؛ شناسه‌های عددی خام به‌عنوان کانال در نظر گرفته می‌شوند)
• Google Chat: spaces/<spaceId> یا users/<userId>
• Slack: channel:<id> یا user:<id> (شناسه خام کانال پذیرفته می‌شود)
• Mattermost (Plugin): channel:<id>، user:<id>، یا @username (شناسه‌های ساده به‌عنوان کانال در نظر گرفته می‌شوند)
• Signal: +E.164، group:<id>، signal:+E.164، signal:group:<id>، یا username:<name>/u:<name>
• iMessage: هندل، chat_id:<id>، chat_guid:<guid>، یا chat_identifier:<id>
• Matrix: @user:server، !room:server، یا #alias:server
• Microsoft Teams: شناسه مکالمه (19:...@thread.tacv2) یا conversation:<id> یا user:<aad-object-id>

جست‌وجوی نام:

• برای ارائه‌دهندگان پشتیبانی‌شده (Discord/Slack/و غیره)، نام کانال‌هایی مانند Help یا #help از طریق کش دایرکتوری حل می‌شوند.
• در صورت نبودن در کش، OpenClaw وقتی ارائه‌دهنده پشتیبانی کند، جست‌وجوی زنده دایرکتوری را امتحان می‌کند.

پرچم‌های رایج

• --channel <name>
• --account <id>
• --target <dest> (کانال یا کاربر مقصد برای send/poll/read/و غیره)
• --targets <name> (تکرارشونده؛ فقط پخش)
• --json
• --dry-run
• --verbose

رفتار SecretRef

• openclaw message پیش از اجرای کنش انتخاب‌شده، SecretRefهای پشتیبانی‌شده کانال را حل می‌کند.
• حل‌کردن در صورت امکان به مقصد کنش فعال محدود می‌شود:
  • در سطح کانال وقتی --channel تنظیم شده باشد (یا از مقصدهای دارای پیشوند مانند discord:... استنباط شود)
  • در سطح حساب وقتی --account تنظیم شده باشد (سراسری‌های کانال + سطح‌های حساب انتخاب‌شده)
  • وقتی --account حذف شده باشد، OpenClaw دامنه SecretRef حساب default را اجبار نمی‌کند
• SecretRefهای حل‌نشده در کانال‌های نامرتبط، کنش پیام هدفمند را مسدود نمی‌کنند.
• اگر SecretRef کانال/حساب انتخاب‌شده حل‌نشده باشد، فرمان برای آن کنش به‌صورت بسته شکست می‌خورد.

کنش‌ها

هسته

• send

  • کانال‌ها: WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (Plugin)/Signal/iMessage/Matrix/Microsoft Teams
  • الزامی: --target، به‌علاوه --message، --media، یا --presentation
  • اختیاری: --media، --presentation، --delivery، --pin، --reply-to، --thread-id، --gif-playback، --force-document، --silent
  • بارهای ارائه مشترک: --presentation بلوک‌های معنایی (text، context، divider، buttons، select) را می‌فرستد که هسته از طریق قابلیت‌های اعلام‌شده کانال انتخاب‌شده رندر می‌کند. ارائه پیام را ببینید.
  • ترجیح‌های تحویل عمومی: --delivery راهنماهای تحویل مانند { "pin": true } را می‌پذیرد؛ --pin میان‌بر تحویل سنجاق‌شده است وقتی کانال از آن پشتیبانی کند.
  • فقط Telegram: --force-document (ارسال تصویرها، GIFها، و ویدئوها به‌صورت سند برای پرهیز از فشرده‌سازی Telegram)
  • فقط Telegram: --thread-id (شناسه موضوع انجمن)
  • فقط Slack: --thread-id (برچسب زمانی رشته؛ --reply-to از همان فیلد استفاده می‌کند)
  • Telegram + Discord: --silent
  • فقط WhatsApp: --gif-playback؛ کانال‌ها/خبرنامه‌های WhatsApp با JID بومی @newsletter خود نشانی‌دهی می‌شوند.

• poll

  • کانال‌ها: WhatsApp/Telegram/Discord/Matrix/Microsoft Teams
  • الزامی: --target، --poll-question، --poll-option (تکرارشونده)
  • اختیاری: --poll-multi
  • فقط Discord: --poll-duration-hours، --silent، --message
  • فقط Telegram: --poll-duration-seconds (5-600)، --silent، --poll-anonymous / --poll-public، --thread-id

• react

  • کانال‌ها: Discord/Google Chat/Slack/Telegram/WhatsApp/Signal/Matrix
  • الزامی: --message-id، --target
  • اختیاری: --emoji، --remove، --participant، --from-me، --target-author، --target-author-uuid
  • نکته: --remove به --emoji نیاز دارد (--emoji را حذف کنید تا واکنش‌های خودتان پاک شوند، اگر پشتیبانی شود؛ /tools/reactions را ببینید)
  • فقط WhatsApp: --participant، --from-me
  • واکنش‌های گروه Signal: --target-author یا --target-author-uuid الزامی است

• reactions

  • کانال‌ها: Discord/Google Chat/Slack/Matrix
  • الزامی: --message-id، --target
  • اختیاری: --limit

• read

  • کانال‌ها: Discord/Slack/Matrix
  • الزامی: --target
  • اختیاری: --limit، --message-id، --before، --after
  • فقط Slack: --message-id یک برچسب زمانی پیام مشخص Slack را می‌خواند؛ با --thread-id ترکیب کنید تا پاسخ دقیق یک رشته خوانده شود.
  • فقط Discord: --around

• edit

  • کانال‌ها: Discord/Slack/Matrix
  • الزامی: --message-id، --message، --target

• delete

  • کانال‌ها: Discord/Slack/Telegram/Matrix
  • الزامی: --message-id، --target

• pin / unpin

  • کانال‌ها: Discord/Slack/Matrix
  • الزامی: --message-id، --target

• pins (فهرست)

  • کانال‌ها: Discord/Slack/Matrix
  • الزامی: --target

• permissions

  • کانال‌ها: Discord/Matrix
  • الزامی: --target
  • فقط Matrix: وقتی رمزگذاری Matrix فعال باشد و کنش‌های راستی‌آزمایی مجاز باشند، در دسترس است

• search

  • کانال‌ها: Discord
  • الزامی: --guild-id، --query
  • اختیاری: --channel-id، --channel-ids (تکرارشونده)، --author-id، --author-ids (تکرارشونده)، --limit

رشته‌ها

• 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

نقش‌ها / کانال‌ها / اعضا / صوت

• role info (Discord): --guild-id
• role add / role remove (Discord): --guild-id، --user-id، --role-id
• channel info (Discord): --target
• channel list (Discord): --guild-id
• member info (Discord/Slack): --user-id (+ --guild-id برای Discord)
• voice status (Discord): --guild-id، --user-id

رویدادها

• event list (Discord): --guild-id
• event create (Discord): --guild-id، --event-name، --start-time
  • اختیاری: --end-time، --desc، --channel-id، --location، --event-type

مدیریت محتوا (Discord)

• timeout: --guild-id، --user-id (--duration-min یا --until اختیاری؛ برای پاک‌کردن timeout هر دو را حذف کنید)
• kick: --guild-id، --user-id (+ --reason)
• ban: --guild-id، --user-id (+ --delete-days، --reason)
  • timeout از --reason نیز پشتیبانی می‌کند

پخش

• broadcast
  • کانال‌ها: هر کانال پیکربندی‌شده؛ از --channel all برای هدف‌گرفتن همه ارائه‌دهندگان استفاده کنید
  • الزامی: --targets <target...>
  • اختیاری: --message، --media، --dry-run

نمونه‌ها

ارسال پاسخ Discord:

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

ارسال پیام با دکمه‌های معنایی:

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"}]}]}'

هسته همان بار presentation را بسته به قابلیت کانال به مولفه‌های Discord، بلوک‌های Slack، دکمه‌های درون‌خطی Telegram، props در Mattermost، یا کارت‌های Teams/Feishu تبدیل می‌کند. برای قرارداد کامل و قواعد fallback، ارائه پیام را ببینید.

ارسال یک بار ارائه غنی‌تر:

openclaw message send --channel googlechat --target spaces/AAA... \  --message "Choose:" \  --presentation '{"title":"Deploy approval","tone":"warning","blocks":[{"type":"text","text":"Choose a path"},{"type":"buttons","buttons":[{"label":"Approve","value":"approve"},{"label":"Decline","value":"decline"}]}]}'

ایجاد نظرسنجی Discord:

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

ایجاد نظرسنجی Telegram (بستن خودکار پس از ۲ دقیقه):

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

ارسال پیام proactive در Teams:

openclaw message send --channel msteams \  --target conversation:19:abc@thread.tacv2 --message "hi"

ایجاد نظرسنجی Teams:

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

واکنش در Slack:

openclaw message react --channel slack \  --target C123 --message-id 456 --emoji "✅"

واکنش در یک گروه Signal:

openclaw message react --channel signal \  --target signal:group:abc123 --message-id 1737630212345 \  --emoji "✅" --target-author-uuid 123e4567-e89b-12d3-a456-426614174000

ارسال دکمه‌های درون‌خطی Telegram از طریق ارائه عمومی:

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

ارسال کارت Teams از طریق ارائه عمومی:

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

ارسال تصویر Telegram به‌صورت سند برای پرهیز از فشرده‌سازی:

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

مرتبط

• مرجع CLI
• ارسال Agent