Skip to main content
The message command provides direct access to messaging channel actions including sending messages, polls, reactions, and more.

​
message send

Send a message to a channel. 
simpleclaw message send --target <destination> --message <text>
​
--target
string
required
Message target (phone number, channel id, user id, etc.)
​
--channel
string
Channel name (e.g., telegram, discord, slack)
​
--account
string
Account id for the channel
​
--message
string
Message body (required unless --media is set)
​
--media
string
Attach media (image/audio/video/document). Accepts local paths or URLs.
​
--buttons
json
Telegram inline keyboard buttons as JSON (array of button rows)
​
--components
json
Discord components payload as JSON
​
--card
json
Adaptive Card JSON object (when supported by the channel)
​
--reply-to
string
Reply-to message id
​
--thread-id
string
Thread id (Telegram forum thread)
​
--gif-playback
boolean
Treat video media as GIF playback (WhatsApp only)
​
--silent
boolean
Send message silently without notification (Telegram and Discord)

​
Examples

# Send a text message
simpleclaw message send --target +15555550123 --message "Hi"

# Send a message with media
simpleclaw message send --target +15555550123 --message "Hi" --media photo.jpg

​
message poll

Create a poll. 
simpleclaw message poll --target <destination> --poll-question <question>
​
--target
string
required
Message target
​
--channel
string
Channel name
​
--account
string
Account id
​
--poll-question
string
required
Poll question
​
--poll-option
string
Poll option (repeat 2-12 times)
​
--poll-multi
boolean
Allow multiple selections
​
--poll-duration-hours
number
Poll duration in hours (Discord)
​
--poll-duration-seconds
number
Poll duration in seconds (Telegram; 5-600)
​
--poll-anonymous
boolean
Send an anonymous poll (Telegram)
​
--poll-public
boolean
Send a non-anonymous poll (Telegram)
​
--message
string
Optional message body
​
--silent
boolean
Send poll silently without notification (Telegram and Discord)
​
--thread-id
string
Thread id (Telegram forum topic / Slack thread ts)
Example: 
simpleclaw message poll --channel discord --target channel:123 --poll-question "Snack?" --poll-option Pizza --poll-option Sushi

​
message react

Add or remove a reaction. 
simpleclaw message react --target <destination> --message-id <id> --emoji <emoji>
​
--target
string
required
Message target
​
--channel
string
Channel name
​
--account
string
Account id
​
--message-id
string
required
Message id
​
--emoji
string
Emoji for reactions
​
--remove
boolean
Remove reaction
​
--participant
string
WhatsApp reaction participant
​
--from-me
boolean
WhatsApp reaction fromMe
​
--target-author
string
Signal reaction target author (uuid or phone)
​
--target-author-uuid
string
Signal reaction target author uuid
Example: 
simpleclaw message react --channel discord --target 123 --message-id 456 --emoji "✅"

​
message reactions

List reactions on a message. 
simpleclaw message reactions --target <destination> --message-id <id>
​
--target
string
required
Message target
​
--message-id
string
required
Message id
​
--limit
number
Result limit

​
Other Subcommands

The message command also includes:
  • message broadcast - Broadcast messages to multiple targets
  • message read - Mark messages as read
  • message edit - Edit sent messages
  • message delete - Delete messages
  • message pin - Pin/unpin messages
  • message permissions - Check message permissions
  • message search - Search messages
  • message thread - Thread operations
  • message emoji - Manage custom emoji
  • message sticker - Manage stickers
Run simpleclaw message <subcommand> --help for detailed options.

Build docs developers (and LLMs) love

Get started for freeTalk to us