{
  "title": "`openclaw message`",
  "content": "Single outbound command for sending messages and channel actions\n(Discord/Google Chat/Slack/Mattermost (plugin)/Telegram/WhatsApp/Signal/iMessage/MS Teams).\n\n* `--channel` required if more than one channel is configured.\n* If exactly one channel is configured, it becomes the default.\n* Values: `whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams` (Mattermost requires plugin)\n\nTarget formats (`--target`):\n\n* WhatsApp: E.164 or group JID\n* Telegram: chat id or `@username`\n* Discord: `channel:<id>` or `user:<id>` (or `<@id>` mention; raw numeric ids are treated as channels)\n* Google Chat: `spaces/<spaceId>` or `users/<userId>`\n* Slack: `channel:<id>` or `user:<id>` (raw channel id is accepted)\n* Mattermost (plugin): `channel:<id>`, `user:<id>`, or `@username` (bare ids are treated as channels)\n* Signal: `+E.164`, `group:<id>`, `signal:+E.164`, `signal:group:<id>`, or `username:<name>`/`u:<name>`\n* iMessage: handle, `chat_id:<id>`, `chat_guid:<guid>`, or `chat_identifier:<id>`\n* MS Teams: conversation id (`19:...@thread.tacv2`) or `conversation:<id>` or `user:<aad-object-id>`\n\n* For supported providers (Discord/Slack/etc), channel names like `Help` or `#help` are resolved via the directory cache.\n* On cache miss, OpenClaw will attempt a live directory lookup when the provider supports it.\n\n* `--channel <name>`\n* `--account <id>`\n* `--target <dest>` (target channel or user for send/poll/read/etc)\n* `--targets <name>` (repeat; broadcast only)\n* `--json`\n* `--dry-run`\n* `--verbose`\n\n* `send`\n  * Channels: WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (plugin)/Signal/iMessage/MS Teams\n  * Required: `--target`, plus `--message` or `--media`\n  * Optional: `--media`, `--reply-to`, `--thread-id`, `--gif-playback`\n  * Telegram only: `--buttons` (requires `channels.telegram.capabilities.inlineButtons` to allow it)\n  * Telegram only: `--thread-id` (forum topic id)\n  * Slack only: `--thread-id` (thread timestamp; `--reply-to` uses the same field)\n  * WhatsApp only: `--gif-playback`\n\n* `poll`\n  * Channels: WhatsApp/Discord/MS Teams\n  * Required: `--target`, `--poll-question`, `--poll-option` (repeat)\n  * Optional: `--poll-multi`\n  * Discord only: `--poll-duration-hours`, `--message`\n\n* `react`\n  * Channels: Discord/Google Chat/Slack/Telegram/WhatsApp/Signal\n  * Required: `--message-id`, `--target`\n  * Optional: `--emoji`, `--remove`, `--participant`, `--from-me`, `--target-author`, `--target-author-uuid`\n  * Note: `--remove` requires `--emoji` (omit `--emoji` to clear own reactions where supported; see /tools/reactions)\n  * WhatsApp only: `--participant`, `--from-me`\n  * Signal group reactions: `--target-author` or `--target-author-uuid` required\n\n* `reactions`\n  * Channels: Discord/Google Chat/Slack\n  * Required: `--message-id`, `--target`\n  * Optional: `--limit`\n\n* `read`\n  * Channels: Discord/Slack\n  * Required: `--target`\n  * Optional: `--limit`, `--before`, `--after`\n  * Discord only: `--around`\n\n* `edit`\n  * Channels: Discord/Slack\n  * Required: `--message-id`, `--message`, `--target`\n\n* `delete`\n  * Channels: Discord/Slack/Telegram\n  * Required: `--message-id`, `--target`\n\n* `pin` / `unpin`\n  * Channels: Discord/Slack\n  * Required: `--message-id`, `--target`\n\n* `pins` (list)\n  * Channels: Discord/Slack\n  * Required: `--target`\n\n* `permissions`\n  * Channels: Discord\n  * Required: `--target`\n\n* `search`\n  * Channels: Discord\n  * Required: `--guild-id`, `--query`\n  * Optional: `--channel-id`, `--channel-ids` (repeat), `--author-id`, `--author-ids` (repeat), `--limit`\n\n* `thread create`\n  * Channels: Discord\n  * Required: `--thread-name`, `--target` (channel id)\n  * Optional: `--message-id`, `--auto-archive-min`\n\n* `thread list`\n  * Channels: Discord\n  * Required: `--guild-id`\n  * Optional: `--channel-id`, `--include-archived`, `--before`, `--limit`\n\n* `thread reply`\n  * Channels: Discord\n  * Required: `--target` (thread id), `--message`\n  * Optional: `--media`, `--reply-to`\n\n* `emoji list`\n  * Discord: `--guild-id`\n  * Slack: no extra flags\n\n* `emoji upload`\n  * Channels: Discord\n  * Required: `--guild-id`, `--emoji-name`, `--media`\n  * Optional: `--role-ids` (repeat)\n\n* `sticker send`\n  * Channels: Discord\n  * Required: `--target`, `--sticker-id` (repeat)\n  * Optional: `--message`\n\n* `sticker upload`\n  * Channels: Discord\n  * Required: `--guild-id`, `--sticker-name`, `--sticker-desc`, `--sticker-tags`, `--media`\n\n### Roles / Channels / Members / Voice\n\n* `role info` (Discord): `--guild-id`\n* `role add` / `role remove` (Discord): `--guild-id`, `--user-id`, `--role-id`\n* `channel info` (Discord): `--target`\n* `channel list` (Discord): `--guild-id`\n* `member info` (Discord/Slack): `--user-id` (+ `--guild-id` for Discord)\n* `voice status` (Discord): `--guild-id`, `--user-id`\n\n* `event list` (Discord): `--guild-id`\n* `event create` (Discord): `--guild-id`, `--event-name`, `--start-time`\n  * Optional: `--end-time`, `--desc`, `--channel-id`, `--location`, `--event-type`\n\n### Moderation (Discord)\n\n* `timeout`: `--guild-id`, `--user-id` (optional `--duration-min` or `--until`; omit both to clear timeout)\n* `kick`: `--guild-id`, `--user-id` (+ `--reason`)\n* `ban`: `--guild-id`, `--user-id` (+ `--delete-days`, `--reason`)\n  * `timeout` also supports `--reason`\n\n* `broadcast`\n  * Channels: any configured channel; use `--channel all` to target all providers\n  * Required: `--targets` (repeat)\n  * Optional: `--message`, `--media`, `--dry-run`\n\nSend a Discord reply:\n\nCreate a Discord poll:\n\nSend a Teams proactive message:\n\nReact in a Signal group:\n\nSend Telegram inline buttons:",
  "code_samples": [
    {
      "code": "openclaw message <subcommand> [flags]",
      "language": "unknown"
    },
    {
      "code": "openclaw message send --channel discord \\\n  --target channel:123 --message \"hi\" --reply-to 456",
      "language": "unknown"
    },
    {
      "code": "openclaw message poll --channel discord \\\n  --target channel:123 \\\n  --poll-question \"Snack?\" \\\n  --poll-option Pizza --poll-option Sushi \\\n  --poll-multi --poll-duration-hours 48",
      "language": "unknown"
    },
    {
      "code": "openclaw message send --channel msteams \\\n  --target conversation:19:abc@thread.tacv2 --message \"hi\"",
      "language": "unknown"
    },
    {
      "code": "openclaw message poll --channel msteams \\\n  --target conversation:19:abc@thread.tacv2 \\\n  --poll-question \"Lunch?\" \\\n  --poll-option Pizza --poll-option Sushi",
      "language": "unknown"
    },
    {
      "code": "openclaw message react --channel slack \\\n  --target C123 --message-id 456 --emoji \"✅\"",
      "language": "unknown"
    },
    {
      "code": "openclaw message react --channel signal \\\n  --target signal:group:abc123 --message-id 1737630212345 \\\n  --emoji \"✅\" --target-author-uuid 123e4567-e89b-12d3-a456-426614174000",
      "language": "unknown"
    },
    {
      "code": "openclaw message send --channel telegram --target @mychat --message \"Choose:\" \\\n  --buttons '[ [{\"text\":\"Yes\",\"callback_data\":\"cmd:yes\"}], [{\"text\":\"No\",\"callback_data\":\"cmd:no\"}] ]'",
      "language": "unknown"
    }
  ],
  "headings": [
    {
      "level": "h2",
      "text": "Usage",
      "id": "usage"
    },
    {
      "level": "h2",
      "text": "Common flags",
      "id": "common-flags"
    },
    {
      "level": "h2",
      "text": "Actions",
      "id": "actions"
    },
    {
      "level": "h3",
      "text": "Core",
      "id": "core"
    },
    {
      "level": "h3",
      "text": "Threads",
      "id": "threads"
    },
    {
      "level": "h3",
      "text": "Emojis",
      "id": "emojis"
    },
    {
      "level": "h3",
      "text": "Stickers",
      "id": "stickers"
    },
    {
      "level": "h3",
      "text": "Roles / Channels / Members / Voice",
      "id": "roles-/-channels-/-members-/-voice"
    },
    {
      "level": "h3",
      "text": "Events",
      "id": "events"
    },
    {
      "level": "h3",
      "text": "Moderation (Discord)",
      "id": "moderation-(discord)"
    },
    {
      "level": "h3",
      "text": "Broadcast",
      "id": "broadcast"
    },
    {
      "level": "h2",
      "text": "Examples",
      "id": "examples"
    }
  ],
  "url": "llms-txt#`openclaw-message`",
  "links": []
}