Skip to main content

​
clawdbot message

Single outbound command for sending messages and provider actions (Discord/Slack/Telegram/WhatsApp/Signal/iMessage/MS Teams).

​
Usage

clawdbot message <subcommand> [flags]
Provider selection:
  • --provider required if more than one provider is configured.
  • If exactly one provider is configured, it becomes the default.
  • Values: whatsapp|telegram|discord|slack|signal|imessage|msteams
Target formats (--to):
  • WhatsApp: E.164 or group JID
  • Telegram: chat id or @username
  • Discord/Slack: channel:<id> or user:<id> (raw id is ambiguous for Discord)
  • Signal: E.164, group:<id>, or signal:+E.164
  • iMessage: handle or chat_id:<id>
  • MS Teams: conversation id (19:[email protected]) or conversation:<id> or user:<aad-object-id>

​
Common flags

  • --provider <name>
  • --account <id>
  • --json
  • --dry-run
  • --verbose

​
Actions

​
Core

  • send
    • Required: --to, --message
    • Optional: --media, --reply-to, --thread-id, --gif-playback
    • Telegram only: --buttons-json (requires "inlineButtons" in telegram.capabilities or telegram.accounts.<id>.capabilities)
  • poll
    • Required: --to, --poll-question, --poll-option (repeat)
    • Optional: --poll-multi, --poll-duration-hours, --message
  • react
    • Required: --to, --message-id
    • Optional: --emoji, --remove, --participant, --from-me, --channel-id
  • reactions
    • Required: --to, --message-id
    • Optional: --limit, --channel-id
  • read
    • Required: --to
    • Optional: --limit, --before, --after, --around, --channel-id
  • edit
    • Required: --to, --message-id, --message
    • Optional: --channel-id
  • delete
    • Required: --to, --message-id
    • Optional: --channel-id
  • pin / unpin
    • Required: --to, --message-id
    • Optional: --channel-id
  • pins (list)
    • Required: --to
    • Optional: --channel-id
  • permissions
    • Required: --to
    • Optional: --channel-id
  • search
    • Required: --guild-id, --query
    • Optional: --channel-id, --channel-ids (repeat), --author-id, --author-ids (repeat), --limit

​
Threads

  • thread create
    • Required: --thread-name, --to (channel id) or --channel-id
    • Optional: --message-id, --auto-archive-min
  • thread list
    • Required: --guild-id
    • Optional: --channel-id, --include-archived, --before, --limit
  • thread reply
    • Required: --to (thread id), --message
    • Optional: --media, --reply-to

​
Emojis

  • emoji list
    • Discord: --guild-id
  • emoji upload
    • Required: --guild-id, --emoji-name, --media
    • Optional: --role-ids (repeat)

​
Stickers

  • sticker send
    • Required: --to, --sticker-id (repeat)
    • Optional: --message
  • sticker upload
    • Required: --guild-id, --sticker-name, --sticker-desc, --sticker-tags, --media

​
Roles / Channels / Members / Voice

  • role info (Discord): --guild-id
  • role add / role remove (Discord): --guild-id, --user-id, --role-id
  • channel info (Discord): --channel-id
  • channel list (Discord): --guild-id
  • member info (Discord/Slack): --user-id (+ --guild-id for Discord)
  • voice status (Discord): --guild-id, --user-id

​
Events

  • event list (Discord): --guild-id
  • event create (Discord): --guild-id, --event-name, --start-time
    • Optional: --end-time, --desc, --channel-id, --location, --event-type

​
Moderation (Discord)

  • timeout: --guild-id, --user-id (+ --duration-min or --until)
  • kick: --guild-id, --user-id
  • ban: --guild-id, --user-id (+ --delete-days)

​
Examples

Send a Discord reply: 
clawdbot message send --provider discord \
  --to channel:123 --message "hi" --reply-to 456
Create a Discord poll: 
clawdbot message poll --provider discord \
  --to channel:123 \
  --poll-question "Snack?" \
  --poll-option Pizza --poll-option Sushi \
  --poll-multi --poll-duration-hours 48
Send a Teams proactive message: 
clawdbot message send --provider msteams \
  --to conversation:19:[email protected] --message "hi"
Create a Teams poll: 
clawdbot message poll --provider msteams \
  --to conversation:19:[email protected] \
  --poll-question "Lunch?" \
  --poll-option Pizza --poll-option Sushi
React in Slack: 
clawdbot message react --provider slack \
  --to C123 --message-id 456 --emoji "✅"
Send Telegram inline buttons: 
clawdbot message send --provider telegram --to @mychat --message "Choose:" \
  --buttons-json '[ [{"text":"Yes","callback_data":"cmd:yes"}], [{"text":"No","callback_data":"cmd:no"}] ]'