OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

訊息

openclaw message

單一傳出命令，用於跨 Discord、Google Chat、iMessage、Matrix、Mattermost（外掛）、Microsoft Teams、Signal、Slack、Telegram 與 WhatsApp 傳送訊息及執行頻道動作。

bash
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）或頻道／電子報 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）。

傳送

bash
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 播放。
bash
openclaw message send --channel discord \  --target channel:123 --message "選擇：" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"核准","value":"approve","style":"success"},{"label":"拒絕","value":"decline","style":"danger"}]}]}'
bash
openclaw message send --channel telegram --target @mychat --message "選擇：" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"是","value":"cmd:yes"},{"label":"否","value":"cmd:no"}]}]}'

Slack 會以原生方式呈現支援的圖表區塊；其他頻道會以可讀文字接收相同的 資料：

bash
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 也會以原生方式呈現明確的表格區塊。其他頻道會以固定格式的文字接收 說明文字及每一列：

bash
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 仍可剖析），且只會呈現在使用者與機器人之間的私人聊天中：

bash
openclaw message send --channel telegram --target 123456789 --message "開啟應用程式：" \  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"啟動","webApp":{"url":"https://example.com/app"}}]}]}'
bash
openclaw message send --channel telegram --target @mychat \  --media ./diagram.png --force-document
bash
openclaw message send --channel msteams \  --target conversation:19:abc@thread.tacv2 \  --presentation '{"title":"狀態更新","blocks":[{"type":"text","text":"建置已完成"}]}'

投票

bash
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。
bash
openclaw message poll --channel telegram \  --target @mychat \  --poll-question "午餐？" \  --poll-option 披薩 --poll-option 壽司 \  --poll-duration-seconds 120 --silent
bash
openclaw message poll --channel msteams \  --target conversation:19:abc@thread.tacv2 \  --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。

廣播

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

將一個承載內容傳送至多個目標。--targets 接受以空格分隔的 清單。使用 --channel all 即可指定所有已設定的提供者。

相關內容

Was this useful?
On this page

On this page