openclaw message

用于发送消息和通道操作的单一出站命令 （Discord/Google Chat/Slack/Mattermost (插件)/Telegram/WhatsApp/Signal/iMessage/MS Teams）。

用法

openclaw message <subcommand> [flags]

通道选择：

• 如果配置了多个通道，则需要 --channel。
• 如果恰好配置了一个通道，则它成为默认值。
• 值：whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams（Mattermost 需要插件）

目标格式（--target）：

• WhatsApp：E.164 或群组 JID
• Telegram：聊天 ID 或 @username
• Discord：channel:<id> 或 user:<id>（或 <@id> 提及；原始数字 ID 被视为通道）
• Google Chat：spaces/<spaceId> 或 users/<userId>
• Slack：channel:<id> 或 user:<id>（接受原始通道 ID）
• Mattermost (插件)：channel:<id>、user:<id> 或 @username（裸 ID 被视为通道）
• 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>
• MS Teams：对话 ID（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

操作

核心

• send

  • 通道：WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (插件)/Signal/iMessage/MS Teams
  • 必需：--target，加上 --message 或 --media
  • 可选：--media、--reply-to、--thread-id、--gif-playback
  • 仅 Telegram：--buttons（需要 channels.telegram.capabilities.inlineButtons 来允许）
  • 仅 Telegram：--thread-id（论坛主题 ID）
  • 仅 Slack：--thread-id（线程时间戳；--reply-to 使用相同字段）
  • 仅 WhatsApp：--gif-playback

• poll

  • 通道：WhatsApp/Discord/MS Teams
  • 必需：--target、--poll-question、--poll-option（重复）
  • 可选：--poll-multi
  • 仅 Discord：--poll-duration-hours、--message

• react

  • 通道：Discord/Google Chat/Slack/Telegram/WhatsApp/Signal
  • 必需：--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

• reactions

  • 通道：Discord/Google Chat/Slack
  • 必需：--message-id、--target
  • 可选：--limit

• read

  • 通道：Discord/Slack
  • 必需：--target
  • 可选：--limit、--before、--after
  • 仅 Discord：--around

• edit

  • 通道：Discord/Slack
  • 必需：--message-id、--message、--target

• delete

  • 通道：Discord/Slack/Telegram
  • 必需：--message-id、--target

• pin / unpin

  • 通道：Discord/Slack
  • 必需：--message-id、--target

• pins (列表)

  • 通道：Discord/Slack
  • 必需：--target

• permissions

  • 通道：Discord
  • 必需：--target

• search

  • 通道：Discord
  • 必需：--guild-id、--query
  • 可选：--channel-id、--channel-ids（重复）、--author-id、--author-ids（重复）、--limit

线程

• thread create

  • 通道：Discord
  • 必需：--thread-name、--target（通道 ID）
  • 可选：--message-id、--auto-archive-min

• thread list

  • 通道：Discord
  • 必需：--guild-id
  • 可选：--channel-id、--include-archived、--before、--limit

• thread reply

  • 通道：Discord
  • 必需：--target（线程 ID）、--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（Discord 需要 --guild-id）
• 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；两者都省略以清除超时）
• kick：--guild-id、--user-id（+ --reason）
• ban：--guild-id、--user-id（+ --delete-days、--reason）
  • timeout 也支持 --reason

广播

• broadcast
  • 通道：任何配置的通道；使用 --channel all 以定位所有提供者
  • 必需：--targets（重复）
  • 可选：--message、--media、--dry-run

示例

发送 Discord 回复：

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

创建 Discord 投票：

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

发送 Teams 主动消息：

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

创建 Teams 投票：

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

在 Slack 中反应：

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

在 Signal 群组中反应：

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

发送 Telegram 内联按钮：

openclaw message send --channel telegram --target @mychat --message "Choose:" \
  --buttons '[ [{"text":"Yes","callback_data":"cmd:yes"}], [{"text":"No","callback_data":"cmd:no"}] ]'