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

​

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 chỉ cấu hình đúng một kênh, kênh đó sẽ 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 thành Plugin sở hữu kênh đó khi có --channel hoặc mục tiêu có tiền tố kênh; nếu không, lệnh sẽ tải các Plugin kênh đã cấu hình để suy luận kênh mặc định.

• WhatsApp: E.164, group JID, hoặc WhatsApp Channel/Newsletter JID (...@newsletter)
• Telegram: id cuộc trò chuyện, @username, hoặc mục tiêu chủ đề diễn đàn (-1001234567890:topic:42, hoặc --thread-id 42)
• Discord: channel:<id> hoặc user:<id> (hoặc nhắc đến <@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: handle, 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 tìm thấy 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ờ phổ biến

• --channel <name>
• --account <id>
• --target <dest> (kênh hoặc người dùng mục tiêu cho send/poll/read/v.v.)
• --targets <name> (lặp lại; chỉ broadcast)
• --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 hành động đã chọn.
• Việc phân giải được giới hạn theo mục tiêu hành động đang hoạt động khi có thể:
  • theo phạm vi kênh khi đặt --channel (hoặc suy luận từ mục tiêu có tiền tố như discord:...)
  • theo phạm vi tài khoản khi đặt --account (globals 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 của 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 hành động nhắn tin có mục tiêu.
• 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 cho hành động đó.

​

Hành động

​

Cốt 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
  • Payload trình bày dùng chung: --presentation gửi các khối ngữ nghĩa (text, context, divider, buttons, select) mà phần 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 phân phối chung: --delivery chấp nhận gợi ý phân phối như { "pin": true }; --pin là dạng viết tắt cho phân phối được ghim khi kênh hỗ trợ.
  • Chỉ Telegram: --force-document (gửi hình ảnh, GIF và video dưới dạng tài liệu để tránh nén của Telegram)
  • 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/Slack/Telegram/WhatsApp/Signal/Matrix
  • Bắt buộc: --message-id, --target
  • Tùy chọn: --emoji, --remove, --participant, --from-me, --target-author, --target-author-uuid
  • Lưu ý: --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
• 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 chính xác 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 (danh sách)
  • 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à cho phép hành động xác minh
• 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)

​

Sticker

• 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
  • Tùy chọn: --end-time, --desc, --channel-id, --location, --event-type

​

Kiểm duyệt (Discord)

• timeout: --guild-id, --user-id (tùy chọn --duration-min hoặc --until; 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

​

Broadcast

• 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...>
  • Tùy chọn: --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 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
• Gửi agent