`openclaw message`

用于跨 Discord、Google Chat、iMessage、Matrix、Mattermost（插件）、Microsoft Teams、Signal、Slack、Telegram 和 WhatsApp 发送消息及执行渠道操作的统一出站命令。

openclaw message <subcommand> [flags]

渠道选择

如果配置了多个渠道，则必须指定 --channel <name>；如果只配置了一个渠道，则默认使用该渠道。
可选值：discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp （Mattermost 需要相应插件）。
带渠道前缀的目标（例如 discord:channel:123）无需显式指定 --channel 即可解析到所属插件。

目标格式（`-t, --target`）

渠道	格式
Discord	`channel:<id>`、`user:<id>`、`<@id>` 提及，或纯数字 ID（视为渠道 ID）
Google Chat	`spaces/<spaceId>` 或 `users/<userId>`
iMessage	句柄、`chat_id:<id>`、`chat_guid:<guid>` 或 `chat_identifier:<id>`
Mattermost（插件）	`channel:<id>`、`user:<id>`、`@username`，或纯 ID（视为渠道）
Matrix	`@user:server`、`!room:server` 或 `#alias:server`
Microsoft Teams	`conversation:<id>`（`19:...@thread.tacv2`）、纯会话 ID 或 `user:<aad-object-id>`
Signal	`+E.164`、`group:<id>`、`uuid:<id>`、`username:<name>`/`u:<name>`，或以上任一格式加上 `signal:` 前缀
Slack	`channel:<id>` 或 `user:<id>`（纯 ID 视为渠道）
Telegram	聊天 ID、`@username`，或论坛主题目标：`<chatId>:topic:<topicId>`（或 `--thread-id <topicId>`）
WhatsApp	E.164、群组 JID（`...@g.us`）或频道/Newsletter JID（`...@newsletter`）

渠道名称查找：对于具有目录的提供商（Discord/Slack 等），Help 或 #help 等名称会通过目录缓存解析；如果缓存未命中且提供商支持实时目录查找，则回退到实时查找。

通用标志

每个操作都接受：--channel <name>、--account <id>、--json、--dry-run、--verbose。需要目标位置的操作还接受 -t, --target <dest>。

SecretRef 解析

openclaw message 会在运行操作前解析渠道 SecretRef，并将范围尽可能缩小：

设置 --channel 时（或从带前缀的目标推断出渠道时）限定到渠道范围
同时设置 --account 时限定到账户范围
两者均未设置时涵盖所有已配置渠道

不相关渠道中未解析的 SecretRef 绝不会阻止定向操作；所选渠道或账户中存在未解析的 SecretRef 时，操作会以关闭方式失败。

操作

核心

操作	渠道	必需项	备注
`send`	Discord、Google Chat、iMessage、Matrix、Mattermost（插件）、Microsoft Teams、Signal、Slack、Telegram、WhatsApp	`--target`，以及 `--message`/`--media`/`--presentation` 之一	请参阅下方的发送。
`poll`	Discord、Matrix、Microsoft Teams、Telegram、WhatsApp	`--target`、`--poll-question`、`--poll-option`（可重复）	请参阅下方的投票。
`react`	Discord、Matrix、Nextcloud Talk、Signal、Slack、Telegram、WhatsApp	`--message-id`、`--target`	`--emoji`、`--remove`（需要 `--emoji`；省略该项可在支持的渠道中清除自己的表情回应，请参阅表情回应）。WhatsApp：`--participant`、`--from-me`。Signal 群组表情回应需要 `--target-author` 或 `--target-author-uuid`。Nextcloud Talk 仅支持添加表情回应；`--remove` 会报错。
`reactions`	Discord、Matrix、Microsoft Teams、Slack	`--message-id`、`--target`	`--limit`。
`read`	Discord、Matrix、Microsoft Teams、Slack	`--target`	`--limit`、`--message-id`、`--before`、`--after`。Discord：`--around`、`--include-thread`。Slack：`--message-id` 读取特定时间戳；与 `--thread-id` 结合可读取准确的线程回复。
`edit`	Discord、Matrix、Microsoft Teams、Slack、Telegram	`--message-id`、`--message`、`--target`	Telegram 论坛线程使用 `--thread-id`。
`delete`	Discord、Matrix、Microsoft Teams、Slack、Telegram	`--message-id`、`--target`
`pin` / `unpin`	Discord、Matrix、Microsoft Teams、Slack	`--message-id`、`--target`	`unpin` 也接受 `--pinned-message-id`（Microsoft Teams：固定项/固定项列表的资源 ID，而非聊天消息 ID）。
`pins`（列表）	Discord、Matrix、Microsoft Teams、Slack	`--target`	`--limit`。
`permissions`	Discord、Matrix	`--target`	Matrix：仅在启用加密并允许验证操作时可用。
`search`	Discord	`--guild-id`、`--query`	`--channel-id`、`--channel-ids`（可重复）、`--author-id`、`--author-ids`（可重复）、`--limit`。
`member info`	Discord、Matrix、Microsoft Teams、Slack	`--user-id`	`--guild-id`（Discord）。

发送

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

--media <path-or-url>：附加图片/音频/视频/文档（本地路径或 URL）。
--presentation <json>：包含 text、context、divider、chart、table、buttons 和 select 块的共享有效载荷，根据各渠道的能力进行渲染。请参阅消息呈现。
--delivery <json>：通用投递偏好，例如 {"pin": true}。当渠道支持固定投递时，--pin 是其简写形式。
--reply-to <id>、--thread-id <id>（Telegram 论坛主题；Slack 线程时间戳，与 --reply-to 使用相同字段）。
--force-document（Telegram、WhatsApp）：将图片/GIF/视频作为文档发送，以避免渠道压缩。
--silent（Telegram、Discord）：发送时不触发通知。
--gif-playback（仅限 WhatsApp）：将视频媒体作为 GIF 播放。

openclaw message send --channel discord \
  --target channel:123 --message "选择：" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"批准","value":"approve","style":"success"},{"label":"拒绝","value":"decline","style":"danger"}]}]}'

openclaw message send --channel telegram --target @mychat --message "选择：" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"是","value":"cmd:yes"},{"label":"否","value":"cmd:no"}]}]}'

Slack 会原生渲染支持的图表块；其他渠道会以可读文本形式接收相同数据：

openclaw message send --channel slack --target channel:C123 \
  --presentation '{"blocks":[{"type":"chart","chartType":"bar","title":"季度收入","categories":["第一季度","第二季度"],"series":[{"name":"收入","values":[120,145]}],"xLabel":"季度"}]}'

Slack 也会原生渲染显式表格块。其他渠道会以确定性文本形式接收说明文字和每一行：

openclaw message send --channel slack --target channel:C123 \
  --presentation '{"title":"销售管线报告","blocks":[{"type":"table","caption":"未结销售管线","headers":["客户","阶段","ARR"],"rows":[["Acme","Won",125000],["Globex","Review",82000]],"rowHeaderColumnIndex":0}]}'

Telegram Mini App 按钮使用 webApp（仍会解析 web_app 以兼容旧版 JSON），并且仅在用户与 Bot 之间的私聊中渲染：

openclaw message send --channel telegram --target 123456789 --message "打开应用：" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"启动","webApp":{"url":"https://example.com/app"}}]}]}'

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

openclaw message send --channel msteams \
  --target conversation:19:abc@thread.tacv2 \
  --presentation '{"title":"状态更新","blocks":[{"type":"text","text":"构建已完成"}]}'

投票

openclaw message poll --channel discord \
  --target channel:123 \
  --poll-question "零食？" \
  --poll-option Pizza --poll-option Sushi \
  --poll-multi --poll-duration-hours 48

--poll-option <choice>：重复 2-12 次。
--poll-multi：允许多选。
Discord：--poll-duration-hours、--silent、--message。
Telegram：--poll-duration-seconds <n>（5-600）、--silent、 --poll-anonymous / --poll-public、--thread-id。

openclaw message poll --channel telegram \
  --target @mychat \
  --poll-question "午餐？" \
  --poll-option Pizza --poll-option Sushi \
  --poll-duration-seconds 120 --silent

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

话题串

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。

表情符号

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。

身份组、频道、语音和事件（Discord）

role info：--guild-id。
role add / role remove：--guild-id、--user-id、--role-id。
channel info：--target。
channel list：--guild-id。
voice status：--guild-id、--user-id。
event list：--guild-id。
event create：必需 --guild-id、--event-name、--start-time；可选 --end-time、--desc、--channel-id、--location、 --event-type、--image <url-or-path>。

管理操作（Discord）

timeout：--guild-id、--user-id；可选 --duration-min 或 --until（两者均省略可清除超时）、--reason。
kick：--guild-id、--user-id、--reason。
ban：--guild-id、--user-id、--delete-days、--reason。

广播

openclaw message broadcast --targets <target...> [--channel all] [--message <text>] [--media <url>] [--dry-run]

将一个有效负载发送到多个目标。--targets 接受以空格分隔的列表。使用 --channel all 可将所有已配置的提供商设为目标。

CLI 命令

RPC 与 API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

模板

技术参考

概念内部机制

项目

Contributing

消息

`openclaw message`

渠道选择

目标格式（`-t, --target`）

通用标志

SecretRef 解析

操作

核心

发送

投票

话题串

表情符号

贴纸

身份组、频道、语音和事件（Discord）

管理操作（Discord）

广播

相关内容

​openclaw message

​渠道选择

​目标格式（-t, --target）

​通用标志

​SecretRef 解析

​操作

​核心

​发送

​投票

​话题串

​表情符号

​贴纸

​身份组、频道、语音和事件（Discord）

​管理操作（Discord）

​广播

​相关内容

`openclaw message`

渠道选择

目标格式（`-t, --target`）

通用标志

SecretRef 解析

操作

核心

发送

投票

话题串

表情符号

贴纸

身份组、频道、语音和事件（Discord）

管理操作（Discord）

广播

相关内容