Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

openclaw message

​

用法

openclaw message <subcommand> [flags]

• 如果設定了多個頻道，則必須使用 --channel。
• 如果只設定了一個頻道，它會成為預設值。
• 值：discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost 需要 Plugin)
• 當存在 --channel 或帶有頻道前綴的目標時，openclaw message 會將所選頻道解析到擁有它的 Plugin；否則它會載入已設定的頻道 Plugin 以推斷預設頻道。

• WhatsApp：E.164、群組 JID，或 WhatsApp Channel/Newsletter JID (...@newsletter)
• Telegram：聊天 id、@username，或論壇主題目標 (-1001234567890:topic:42，或 --thread-id 42)
• Discord：channel:<id> 或 user:<id> (或 <@id> 提及；原始數字 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：對話 id (19:...@thread.tacv2) 或 conversation:<id> 或 user:<aad-object-id>

• 對於支援的提供者 (Discord/Slack/等)，像 Help 或 #help 這類頻道名稱會透過目錄快取解析。
• 快取未命中時，如果提供者支援，OpenClaw 會嘗試即時目錄查詢。

​

常用旗標

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

​

SecretRef 行為

• openclaw message 會在執行所選動作前解析支援的頻道 SecretRefs。
• 解析會盡可能限定在作用中動作目標範圍內：
  • 設定 --channel 時為頻道範圍 (或從像 discord:... 這類帶前綴目標推斷)
  • 設定 --account 時為帳號範圍 (頻道全域 + 所選帳號表面)
  • 省略 --account 時，OpenClaw 不會強制使用 default 帳號 SecretRef 範圍
• 不相關頻道上未解析的 SecretRefs 不會阻擋目標明確的訊息動作。
• 如果所選頻道/帳號 SecretRef 未解析，該指令會對該動作以失敗關閉。

​

動作

​

核心

• send
  • 頻道：WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (Plugin)/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)，核心會透過所選頻道宣告的能力進行渲染。請參閱訊息呈現。
  • 通用遞送偏好：--delivery 接受像 { "pin": true } 這類遞送提示；當頻道支援時，--pin 是釘選遞送的簡寫。
  • 僅限 Telegram：--force-document (將圖片、GIF 和影片作為文件傳送，以避免 Telegram 壓縮)
  • 僅限 Telegram：--thread-id (論壇主題 id)
  • 僅限 Slack：--thread-id (討論串時間戳；--reply-to 使用同一欄位)
  • Telegram + Discord：--silent
  • 僅限 WhatsApp：--gif-playback；WhatsApp Channels/Newsletters 使用其原生 @newsletter JID 定址。
• 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、--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

​

討論串

• 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；兩者皆省略可清除 timeout)
• kick：--guild-id、--user-id (+ --reason)
• ban：--guild-id、--user-id (+ --delete-days、--reason)
  • timeout 也支援 --reason

​

Broadcast

• broadcast
  • 頻道：任何已設定的頻道；使用 --channel all 以目標所有提供者
  • 必要：--targets <target...>
  • 選用：--message、--media、--dry-run

​

範例

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"}]}]}'

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"}]}]}'

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

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

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

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

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

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

openclaw message send --channel telegram --target @mychat --message "Choose:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Yes","value":"cmd:yes"},{"label":"No","value":"cmd:no"}]}]}'

openclaw message send --channel msteams \
  --target conversation:19:abc@thread.tacv2 \
  --presentation '{"title":"Status update","blocks":[{"type":"text","text":"Build completed"}]}'

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

​

相關

• CLI 參考
• Agent 傳送