message

openclaw message

用於發送訊息和頻道動作的單一出站指令 (Discord/Google Chat/iMessage/Matrix/Mattermost (plugin)/Microsoft Teams/Signal/Slack/Telegram/WhatsApp)。

使用方式

openclaw message <subcommand> [flags]

頻道選擇：

• --channel 如果設定了一個以上的頻道則為必填。
• 如果僅設定一個頻道，它將成為預設值。
• 數值：discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost 需要 plugin)

目標格式 (--target)：

• WhatsApp：E.164 或群組 JID
• Telegram：chat id 或 @username
• Discord：channel:<id> 或 user:<id> (或 <@id> mention；原始數字 id 被視為頻道)
• Google Chat：spaces/<spaceId> 或 users/<userId>
• Slack：channel:<id> 或 user:<id> (接受原始頻道 id)
• Mattermost (plugin)：channel:<id>、user:<id> 或 @username (純 id 被視為頻道)
• Signal：+E.164、group:<id>、signal:+E.164、signal:group:<id> 或 username:<name>/u:<name>
• iMessage：handle、chat_id:<id>、chat_guid:<guid> 或 chat_identifier:<id>
• Matrix：@user:server、!room:server 或 #alias:server
• Microsoft Teams：conversation id (19:[email protected]) 或 conversation:<id> 或 user:<aad-object-id>

名稱查找：

• 對於支援的供應商 (Discord/Slack/等)，頻道名稱如 Help 或 #help 會透過目錄快取解析。
• 若快取未命中 (cache miss)，當供應商支援時，OpenClaw 將嘗試即時目錄查找。

通用旗標

• --channel <name>
• --account <id>
• --target <dest> (send/poll/read/etc 的目標頻道或使用者)
• --targets <name> (重複；僅限廣播)
• --json
• --dry-run
• --verbose

SecretRef 行為

• openclaw message 會在執行選定的動作之前解析支援的頻道 SecretRefs。
• 解析範圍盡可能限定於作用中的動作目標：
  • 當設定 --channel 時限定為頻道範圍 (或從帶有前綴的目標推斷，例如 discord:...)
  • 當設定 --account 時限定為帳戶範圍 (頻道全域變數 + 選定的帳戶 surface)
  • 當省略 --account 時，OpenClaw 不會強制使用 default 帳戶 SecretRef 範圍
• 不相關頻道上未解析的 SecretRefs 不會阻擋目標訊息動作。
• 若選定的頻道/帳戶 SecretRef 未解析，該動作的指令將以失敗封閉 (fails closed) 處理。

動作

核心

• send

  • 頻道：WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (plugin)/Signal/iMessage/Matrix/Microsoft Teams
  • 必要項目：--target，加上 --message 或 --media
  • 可選：--media、--reply-to、--thread-id、--gif-playback
  • 僅限 Telegram：--buttons（需要 channels.telegram.capabilities.inlineButtons 才能允許）
  • 僅限 Telegram：--force-document（將圖片和 GIF 作為文件發送以避免 Telegram 壓縮）
  • 僅限 Telegram：--thread-id（論壇主題 ID）
  • 僅限 Slack：--thread-id（討論串時間戳；--reply-to 使用相同欄位）
  • 僅限 WhatsApp：--gif-playback

• poll

  • 頻道：WhatsApp/Telegram/Discord/Matrix/Microsoft Teams
  • 必填：--target、--poll-question、--poll-option（重複）
  • 可選：--poll-multi
  • 僅限 Discord：--poll-duration-hours、--silent、--message
  • 僅限 Telegram：--poll-duration-seconds（5-600）、--silent、--poll-anonymous / --poll-public、--thread-id

• react

  • 頻道：Discord/Google Chat/Slack/Telegram/WhatsApp/Signal/Matrix
  • 必填：--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/Matrix
  • 必填：--message-id、--target
  • 可選：--limit

• read

  • 頻道：Discord/Slack/Matrix
  • 必填：--target
  • 選填：--limit、--before、--after
  • 僅限 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

討論串

• 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

角色 / 頻道 / 成員 / 語音

• 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 send --channel discord \
  --target channel:123 --message "Choose:" \
  --components '{"text":"Choose a path","blocks":[{"type":"actions","buttons":[{"label":"Approve","style":"success"},{"label":"Decline","style":"danger"}]}]}'

請參閱 Discord 元件 以了解完整架構。

建立 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:" \
  --buttons '[ [{"text":"Yes","callback_data":"cmd:yes"}], [{"text":"No","callback_data":"cmd:no"}] ]'

將 Telegram 圖片以文件形式傳送以避免壓縮：

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