訊息

​

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:[e-mail]2）、純交談 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（[e-mail]）或頻道／電子報 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":["Q1","Q2"],"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（舊版 JSON 中的 web_app 仍可剖析），且只會呈現在使用者與機器人之間的私人聊天中：

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:[e-mail]2 \
  --presentation '{"title":"狀態更新","blocks":[{"type":"text","text":"建置已完成"}]}'

​

投票

openclaw message poll --channel discord \
  --target channel:123 \
  --poll-question "點心？" \
  --poll-option 披薩 --poll-option 壽司 \
  --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 披薩 --poll-option 壽司 \
  --poll-duration-seconds 120 --silent

openclaw message poll --channel msteams \
  --target conversation:19:[e-mail]2 \
  --poll-question "午餐？" \
  --poll-option 披薩 --poll-option 壽司

​

討論串

• 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 即可指定所有已設定的提供者。

​

相關內容

• 命令列介面參考
• 代理程式傳送
• 訊息呈現