​

openclaw message

​

Cách sử dụng

openclaw message <subcommand> [flags]

• Bắt buộc có --channel nếu cấu hình nhiều hơn một kênh.
• Nếu cấu hình đúng một kênh, kênh đó trở thành mặc định.
• Giá trị: discord|googlechat|imessage|matrix|mattermost|msteams|signal|slack|telegram|whatsapp (Mattermost yêu cầu Plugin)
• openclaw message phân giải kênh đã chọn tới Plugin sở hữu kênh đó khi có --channel hoặc đích có tiền tố kênh; nếu không, lệnh tải các Plugin kênh đã cấu hình để suy luận kênh mặc định.

• WhatsApp: E.164, JID nhóm, hoặc JID WhatsApp Channel/Newsletter (...@newsletter)
• Telegram: id cuộc trò chuyện, @username, hoặc đích chủ đề diễn đàn (-1001234567890:topic:42, hoặc --thread-id 42)
• Discord: channel:<id> hoặc user:<id> (hoặc đề cập <@id>; id số thô được xem là kênh)
• Google Chat: spaces/<spaceId> hoặc users/<userId>
• Slack: channel:<id> hoặc user:<id> (chấp nhận id kênh thô)
• Mattermost (Plugin): channel:<id>, user:<id>, hoặc @username (id trần được xem là kênh)
• Signal: +E.164, group:<id>, signal:+E.164, signal:group:<id>, hoặc username:<name>/u:<name>
• iMessage: định danh, chat_id:<id>, chat_guid:<guid>, hoặc chat_identifier:<id>
• Matrix: @user:server, !room:server, hoặc #alias:server
• Microsoft Teams: id cuộc hội thoại (19:...@thread.tacv2) hoặc conversation:<id> hoặc user:<aad-object-id>

• Với các nhà cung cấp được hỗ trợ (Discord/Slack/v.v.), tên kênh như Help hoặc #help được phân giải qua bộ nhớ đệm thư mục.
• Khi không có trong bộ nhớ đệm, OpenClaw sẽ thử tra cứu thư mục trực tiếp nếu nhà cung cấp hỗ trợ.

​

Cờ thường dùng

• --channel <name>
• --account <id>
• --target <dest> (kênh đích hoặc người dùng cho send/poll/read/v.v.)
• --targets <name> (lặp lại; chỉ phát sóng)
• --json
• --dry-run
• --verbose

​

Hành vi SecretRef

• openclaw message phân giải các SecretRef kênh được hỗ trợ trước khi chạy thao tác đã chọn.
• Việc phân giải được giới hạn theo đích thao tác đang hoạt động khi có thể:
  • theo phạm vi kênh khi đặt --channel (hoặc được suy luận từ đích có tiền tố như discord:...)
  • theo phạm vi tài khoản khi đặt --account (biến toàn cục của kênh + các bề mặt tài khoản đã chọn)
  • khi bỏ qua --account, OpenClaw không ép phạm vi SecretRef tài khoản default
• SecretRef chưa phân giải trên các kênh không liên quan không chặn thao tác tin nhắn có đích cụ thể.
• Nếu SecretRef của kênh/tài khoản đã chọn chưa được phân giải, lệnh sẽ đóng thất bại đối với thao tác đó.

​

Thao tác

​

Lõi

• send
  • Kênh: WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (Plugin)/Signal/iMessage/Matrix/Microsoft Teams
  • Bắt buộc: --target, cộng với --message, --media, hoặc --presentation
  • Tùy chọn: --media, --presentation, --delivery, --pin, --reply-to, --thread-id, --gif-playback, --force-document, --silent
  • Tải trình bày dùng chung: --presentation gửi các khối ngữ nghĩa (text, context, divider, buttons, select) mà lõi kết xuất thông qua các khả năng đã khai báo của kênh được chọn. Xem Trình bày tin nhắn.
  • Tùy chọn gửi chung: --delivery chấp nhận gợi ý gửi như { "pin": true }; --pin là dạng viết tắt cho gửi đã ghim khi kênh hỗ trợ.
  • Telegram + WhatsApp: --force-document (gửi hình ảnh, GIF và video dưới dạng tài liệu để tránh nén kênh)
  • Chỉ Telegram: --thread-id (id chủ đề diễn đàn)
  • Chỉ Slack: --thread-id (dấu thời gian luồng; --reply-to dùng cùng trường)
  • Telegram + Discord: --silent
  • Chỉ WhatsApp: --gif-playback; WhatsApp Channels/Newsletters được định địa chỉ bằng JID @newsletter gốc của chúng.
• poll
  • Kênh: WhatsApp/Telegram/Discord/Matrix/Microsoft Teams
  • Bắt buộc: --target, --poll-question, --poll-option (lặp lại)
  • Tùy chọn: --poll-multi
  • Chỉ Discord: --poll-duration-hours, --silent, --message
  • Chỉ Telegram: --poll-duration-seconds (5-600), --silent, --poll-anonymous / --poll-public, --thread-id
• react
  • Kênh: Discord/Google Chat/Matrix/Nextcloud Talk/Signal/Slack/Telegram/WhatsApp
  • Bắt buộc: --message-id, --target
  • Tùy chọn: --emoji, --remove, --participant, --from-me, --target-author, --target-author-uuid
  • Ghi chú: --remove yêu cầu --emoji (bỏ qua --emoji để xóa phản ứng của chính bạn ở nơi được hỗ trợ; xem /tools/reactions)
  • Chỉ WhatsApp: --participant, --from-me
  • Phản ứng nhóm Signal: bắt buộc có --target-author hoặc --target-author-uuid
  • Nextcloud Talk: chỉ thêm phản ứng; --remove bị từ chối với lỗi rõ ràng (xem /tools/reactions)
• reactions
  • Kênh: Discord/Google Chat/Slack/Matrix
  • Bắt buộc: --message-id, --target
  • Tùy chọn: --limit
• read
  • Kênh: Discord/Slack/Matrix
  • Bắt buộc: --target
  • Tùy chọn: --limit, --message-id, --before, --after
  • Chỉ Slack: --message-id đọc một dấu thời gian tin nhắn Slack cụ thể; kết hợp với --thread-id để đọc đúng một phản hồi trong luồng.
  • Chỉ Discord: --around
• edit
  • Kênh: Discord/Slack/Matrix
  • Bắt buộc: --message-id, --message, --target
• delete
  • Kênh: Discord/Slack/Telegram/Matrix
  • Bắt buộc: --message-id, --target
• pin / unpin
  • Kênh: Discord/Slack/Matrix
  • Bắt buộc: --message-id, --target
• pins (liệt kê)
  • Kênh: Discord/Slack/Matrix
  • Bắt buộc: --target
• permissions
  • Kênh: Discord/Matrix
  • Bắt buộc: --target
  • Chỉ Matrix: khả dụng khi mã hóa Matrix được bật và thao tác xác minh được cho phép
• search
  • Kênh: Discord
  • Bắt buộc: --guild-id, --query
  • Tùy chọn: --channel-id, --channel-ids (lặp lại), --author-id, --author-ids (lặp lại), --limit

​

Luồng

• thread create
  • Kênh: Discord
  • Bắt buộc: --thread-name, --target (id kênh)
  • Tùy chọn: --message-id, --message, --auto-archive-min
• thread list
  • Kênh: Discord
  • Bắt buộc: --guild-id
  • Tùy chọn: --channel-id, --include-archived, --before, --limit
• thread reply
  • Kênh: Discord
  • Bắt buộc: --target (id luồng), --message
  • Tùy chọn: --media, --reply-to

​

Emoji

• emoji list
  • Discord: --guild-id
  • Slack: không có cờ bổ sung
• emoji upload
  • Kênh: Discord
  • Bắt buộc: --guild-id, --emoji-name, --media
  • Tùy chọn: --role-ids (lặp lại)

​

Nhãn dán

• sticker send
  • Kênh: Discord
  • Bắt buộc: --target, --sticker-id (lặp lại)
  • Tùy chọn: --message
• sticker upload
  • Kênh: Discord
  • Bắt buộc: --guild-id, --sticker-name, --sticker-desc, --sticker-tags, --media

​

Vai trò / Kênh / Thành viên / Thoại

• 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 (+ --guild-id cho Discord)
• voice status (Discord): --guild-id, --user-id

​

Sự kiện

• event list (Discord): --guild-id
• event create (Discord): --guild-id, --event-name, --start-time
  • Không bắt buộc: --end-time, --desc, --channel-id, --location, --event-type

​

Kiểm duyệt (Discord)

• timeout: --guild-id, --user-id (--duration-min hoặc --until không bắt buộc; bỏ qua cả hai để xóa timeout)
• kick: --guild-id, --user-id (+ --reason)
• ban: --guild-id, --user-id (+ --delete-days, --reason)
  • timeout cũng hỗ trợ --reason

​

Phát thông báo

• broadcast
  • Kênh: bất kỳ kênh nào đã cấu hình; dùng --channel all để nhắm đến tất cả nhà cung cấp
  • Bắt buộc: --targets <target...>
  • Không bắt buộc: --message, --media, --dry-run

​

Ví dụ

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 telegram --target 123456789 --message "Open app:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Launch","webApp":{"url":"https://example.com/app"}}]}]}'

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

​

Liên quan

• Tham chiếu CLI
• Agent send