Message CLI

Send, read, and manage messages and channel actions

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 [phone] --message "Hi"

# Send a message with media
simpleclaw message send --target [phone] --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.