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

CLI commands

پیام

openclaw message

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

کاربرد

Code
openclaw message <subcommand> [flags]

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

  • اگر بیش از یک کانال پیکربندی شده باشد، --channel الزامی است.
  • اگر دقیقا یک کانال پیکربندی شده باشد، همان کانال پیش‌فرض می‌شود.
  • مقادیر: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost به Plugin نیاز دارد)
  • openclaw message وقتی --channel یا هدفی با پیشوند کانال وجود داشته باشد، کانال انتخاب‌شده را به 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> (کانال یا کاربر هدف برای ارسال/نظرسنجی/خواندن/و غیره)
  • --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 + WhatsApp: --force-document (ارسال تصویرها، GIFها و ویدئوها به‌صورت سند برای جلوگیری از فشرده‌سازی کانال)
    • فقط 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/Matrix/Nextcloud Talk/Signal/Slack/Telegram/WhatsApp
    • الزامی: --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 الزامی است
    • Nextcloud Talk: فقط افزودن واکنش؛ --remove با خطایی روشن رد می‌شود (/tools/reactions را ببینید)

  • 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:

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

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

Code
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، ارائه پیام را ببینید.

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

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

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

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

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

ارسال پیام پیش‌دستانه Teams:

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

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

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

واکنش در Slack:

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

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

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

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

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

ارسال دکمه Mini App در Telegram از طریق ارائه عمومی:

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

دکمه‌های وب‌اپ Telegram فقط در چت‌های خصوصی بین کاربر و ربات پشتیبانی می‌شوند. بارهای داده JSON قدیمی‌تر که از web_app استفاده می‌کنند همچنان parse می‌شوند، اما webApp فیلد canonical ارائه است.

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

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

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

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

مرتبط

Was this useful?
On this page

On this page