跳转到内容
OpenClaw Docs

Message

openclaw message

Section titled “openclaw message”

用于发送消息和渠道操作的单个出站命令 (Discord/Google Chat/iMessage/Matrix/Mattermost (plugin)/Microsoft Teams/Signal/Slack/Telegram/WhatsApp)。

用法

Section titled “用法”
openclaw message <subcommand> [flags]

频道选择：

  • --channel 如果配置了多个渠道则为必填项。
  • 如果恰好配置了一个频道，它将成为默认频道。
  • 取值：discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsappMattermost（Mattermost 需要插件）
  • 当存在 --channel 或带渠道前缀的目标时，openclaw message 会将所选渠道解析为其所属插件；否则，它会加载已配置的渠道插件以推断默认渠道。

目标格式（--target）：

  • WhatsApp：E.164、群组 JID 或 WhatsApp Channel/Newsletter JID（WhatsAppWhatsApp...@newsletter）
  • Telegram：chat id、Telegram@username 或论坛话题目标（-1001234567890:topic:42 或 --thread-id 42）
  • Discord：Discordchannel:<id> 或 user:<id>（或 <@id> 提及；原始数字 ID 将被视为渠道）
  • Google Chat：Google Chatspaces/<spaceId> 或 users/<userId>
  • Slack：Slackchannel:<id> 或 user:<id>（接受原始渠道 ID）
  • Mattermost（插件）：Mattermostchannel:<id>、user:<id> 或 @username（纯 ID 将被视为渠道）
  • Signal：Signal+E.164、group:<id>、signal:+E.164、signal:group:<id> 或 username:<name>/u:<name>
  • iMessage：handle、iMessagechat_id:<id>、chat_guid:<guid> 或 chat_identifier:<id>
  • Matrix：Matrix@user:server、!room:server 或 #alias:server
  • Microsoft Teams：对话 ID (Microsoft Teams19:[email protected]) 或 conversation:<id> 或 user:<aad-object-id>

名称查找：

  • 对于支持的提供商（Discord/Slack/等），诸如 DiscordSlackHelp 或 #help 之类的渠道名称将通过目录缓存进行解析。
  • 如果缓存未命中，当提供商支持时，OpenClaw 将尝试实时目录查找。

通用标志

Section titled “通用标志”
  • --channel <name>
  • --account <id>
  • --target <dest> (用于发送/投票/读取等的目标渠道或用户)
  • --targets <name> (重复；仅限广播)
  • --json
  • --dry-run
  • --verbose

SecretRef 行为

Section titled “SecretRef 行为”
  • openclaw message 在运行选定操作之前解析受支持的渠道 SecretRefs。
  • 解析范围在可能时限定于当前操作目标：
    • 设置 --channel 时（或从诸如 discord:... 的带前缀目标推断时）为渠道范围
    • 设置 --account 时为账户范围（渠道全局变量 + 选定的账户界面）
    • 当省略 --accountOpenClaw 时，OpenClaw 不会强制 default 账户 SecretRef 范围
  • 不相关渠道上未解析的 SecretRef 不会阻止目标消息操作。
  • 如果所选渠道/账户的 SecretRef 未解析，该命令的该操作将以失败关闭。

操作

Section titled “操作”

核心

Section titled “核心”

  • send

    • 渠道：WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (插件)/Signal/iMessage/Matrix/Microsoft Teams
    • 必需：--target，加上 --message、--media 或 --presentation
    • 可选：--media、--presentation、--delivery、--pin、--reply-to、--thread-id、--gif-playback、--force-document、--silent
    • 共享展示负载：--presentation 发送语义块（text、context、divider、buttons、select），核心通过所选渠道声明的功能进行渲染。参见 Message Presentation。
    • 通用投递首选项：--delivery 接受 { "pin": true } 等投递提示；当渠道支持时，--pin 是固定投递的简写形式。
    • Telegram + WhatsApp：Telegram + WhatsApp：--force-document（将图片、GIF 和视频作为文档发送以避免渠道压缩）
    • 仅限 Telegram：Telegram only：--thread-id（论坛主题 ID）
    • 仅限 Slack：Slack only：--thread-id（线程时间戳；--reply-to 使用相同的字段）
    • Telegram + Discord：Telegram + Discord：--silent
    • 仅限 WhatsApp：WhatsApp only：--gif-playbackWhatsApp；WhatsApp 渠道/时事通讯通过其原生 @newsletter JID 进行寻址。

  • poll

    • 渠道：WhatsApp/Telegram/Discord/Matrix/Microsoft Teams
    • 必填：--target、--poll-question、--poll-option（可重复）
    • 可选：--poll-multi
    • 仅限 Discord：Discord only：--poll-duration-hours、--silent、--message
    • 仅限 Telegram：Telegram only：--poll-duration-seconds（5-600）、--silent、--poll-anonymous / --poll-public、--thread-id

  • react

    • 渠道：Discord/Google Chat/Matrix/Nextcloud Talk/Signal/Slack/Telegram/WhatsApp
    • 必填：--message-id、--target
    • 可选：--emoji、--remove、--participant、--from-me、--target-author、--target-author-uuid
    • 注意：--remove 需要 --emoji（在支持的情况下，省略 --emoji 以清除自己的表情反应；请参见 /tools/reactions）
    • 仅限 WhatsApp：WhatsApp only：--participant、--from-me
    • Signal 群组回应：Signal--target-author 或 --target-author-uuid 为必填项
    • Nextcloud Talk：仅添加表情回应；--remove 会被拒绝并返回明确的错误（参见 /tools/reactions）

  • reactions

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

  • read

    • 渠道：Discord/Slack/Matrix
    • 必需：--target
    • 可选：--limit、--message-id、--before、--after
    • 仅 Slack：--message-id 读取特定的 Slack 消息时间戳；与 --thread-id 结合使用以读取确切的线程回复。
    • 仅 Discord：--around

  • edit

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

  • delete

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

  • pin / unpin

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

  • pins（列表）

    • 渠道：Discord/Slack/Matrix
    • 必需：--target

  • permissions

    • 渠道：Discord/Matrix
    • 必需：--target
    • 仅限 Matrix：当启用 Matrix 加密并允许验证操作时可用

  • search

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

线程

Section titled “线程”

  • thread create

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

  • thread list

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

  • thread reply

    • 渠道：Discord
    • 必需：--target（线程 ID）、--message
    • 可选：--media、--reply-to

表情符号

Section titled “表情符号”

  • emoji list

    • Discord：--guild-id
    • Slack：无额外标志

  • emoji upload

    • 渠道：Discord
    • 必填：--guild-id、--emoji-name、--media
    • 可选：--role-ids（可重复）

表情贴纸

Section titled “表情贴纸”

  • sticker send

    • 频道：Discord
    • 必填：--target、--sticker-id（可重复）
    • 可选：--message

  • sticker upload

    • 频道：Discord
    • 必填：--guild-id、--sticker-name、--sticker-desc、--sticker-tags、--media

角色 / 频道 / 成员 / 语音

Section titled “角色 / 频道 / 成员 / 语音”
  • 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

事件

Section titled “事件”
  • event list (Discord)：--guild-id
  • event create (Discord)：--guild-id、--event-name、--start-time
    • 可选：--end-time、--desc、--channel-id、--location、--event-type

管理 (Discord)

Section titled “管理 (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

广播

Section titled “广播”
  • broadcast
    • 渠道：任何已配置的渠道；使用 --channel all 来定位所有提供商
    • 必需：--targets <target...>
    • 可选：--message, --media, --dry-run

示例

Section titled “示例”

发送一条 Discord 回复：

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

发送带有语义按钮的消息：

openclaw message send --channel discord \
  --target channel:123 --message "Choose:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Approve","value":"approve","style":"success"},{"label":"Decline","value":"decline","style":"danger"}]}]}'

Core 根据渠道能力，将相同的 presentation 载荷渲染为 Discord 组件、Slack 块、Telegram 内联按钮、Mattermost 属性或 Teams/Feishu 卡片。有关完整协议和回退规则，请参阅 消息展示。

发送更丰富的展示载荷：

Terminal window
openclaw message send --channel googlechat --target spaces/AAA... \
  --message "Choose:" \
  --presentation '{"title":"Deploy approval","tone":"warning","blocks":[{"type":"text","text":"Choose a path"},{"type":"buttons","buttons":[{"label":"Approve","value":"approve"},{"label":"Decline","value":"decline"}]}]}'

创建 Discord 投票：

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

创建 Telegram 投票（2分钟后自动关闭）：

openclaw message poll --channel telegram \
  --target @mychat \
  --poll-question "Lunch?" \
  --poll-option Pizza --poll-option Sushi \
  --poll-duration-seconds 120 --silent

发送 Teams 主动消息：

openclaw message send --channel msteams \
  --target conversation:19:[email protected] --message "hi"

创建 Teams 投票：

openclaw message poll --channel msteams \
  --target conversation:19:[email protected] \
  --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:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Yes","value":"cmd:yes"},{"label":"No","value":"cmd:no"}]}]}'

通过通用展示发送 Telegram Mini App 按钮：

openclaw message send --channel telegram --target 123456789 --message "Open app:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Launch","webApp":{"url":"https://example.com/app"}}]}]}'

Telegram Web App 按钮仅支持在用户和机器人之间的私人聊天中使用。使用 web_app 的旧 JSON 载荷仍然可以解析，但 webApp 是规范的展示字段。

通过通用展示发送 Teams 卡片：

Terminal window
openclaw message send --channel msteams \
  --target conversation:19:[email protected] \
  --presentation '{"title":"Status update","blocks":[{"type":"text","text":"Build completed"}]}'

发送 Telegram 或 WhatsApp 图片作为文档以避免压缩：

Terminal window
openclaw message send --channel telegram --target @mychat \
  --media ./diagram.png --force-document

相关

Section titled “相关”