Chuyển đến nội dung chính

Documentation Index

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

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

​
openclaw message

Lệnh gửi đi duy nhất để gửi tin nhắn và hành động kênh (Discord/Google Chat/iMessage/Matrix/Mattermost (Plugin)/Microsoft Teams/Signal/Slack/Telegram/WhatsApp).

​
Cách sử dụng

openclaw message <subcommand> [flags]
Chọn kênh:
  • Bắt buộc có --channel nếu có nhiều hơn một kênh được cấu hình.
  • Nếu đúng một kênh được cấu hì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 thành Plugin sở hữu kênh đó khi có --channel hoặc đích 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.
Định dạng đích (--target):
  • WhatsApp: E.164 hoặc JID nhóm
  • Telegram: id cuộc trò chuyện hoặc @username
  • 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: 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 trò chuyện (19:...@thread.tacv2) hoặc conversation:<id> hoặc user:<aad-object-id>
Tra cứu tên:
  • 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 đích 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 trong đích hành động đ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 (phạm vi 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 hành động nhắn tin 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 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
    • Tải trọng 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 qua các năng lực đã 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 các gợi ý phân phối như { "pin": true }; --pin là cách 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 và GIF 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
  • 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 mình ở 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, --before, --after
    • 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à các hành động xác minh được 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

​
Biểu tượng cảm xúc

  • 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
    • 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 đã cấu hình nào; 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ụ

Gửi phản hồi Discord: 
openclaw message send --channel discord \
  --target channel:123 --message "hi" --reply-to 456
Gửi tin nhắn với các nút ngữ nghĩa: 
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"}]}]}'
Lõi kết xuất cùng tải trọng presentation thành các thành phần Discord, khối Slack, nút nội tuyến Telegram, props Mattermost, hoặc thẻ Teams/Feishu tùy theo năng lực kênh. Xem Trình bày tin nhắn để biết hợp đồng đầy đủ và quy tắc dự phòng. Gửi tải trọng trình bày phong phú hơn: 
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"}]}]}'
Tạo cuộc thăm dò Discord: 
openclaw message poll --channel discord \
  --target channel:123 \
  --poll-question "Snack?" \
  --poll-option Pizza --poll-option Sushi \
  --poll-multi --poll-duration-hours 48
Tạo cuộc thăm dò Telegram (tự động đóng sau 2 phút): 
openclaw message poll --channel telegram \
  --target @mychat \
  --poll-question "Lunch?" \
  --poll-option Pizza --poll-option Sushi \
  --poll-duration-seconds 120 --silent
Gửi tin nhắn chủ động Teams: 
openclaw message send --channel msteams \
  --target conversation:19:abc@thread.tacv2 --message "hi"
Tạo cuộc thăm dò Teams: 
openclaw message poll --channel msteams \
  --target conversation:19:abc@thread.tacv2 \
  --poll-question "Lunch?" \
  --poll-option Pizza --poll-option Sushi
Phản ứng trong Slack: 
openclaw message react --channel slack \
  --target C123 --message-id 456 --emoji "✅"
Phản ứng trong nhóm Signal: 
openclaw message react --channel signal \
  --target signal:group:abc123 --message-id 1737630212345 \
  --emoji "✅" --target-author-uuid 123e4567-e89b-12d3-a456-426614174000
Gửi nút nội tuyến Telegram qua trình bày chung: 
openclaw message send --channel telegram --target @mychat --message "Choose:" \
  --presentation '{"blocks":[{"type":"buttons","buttons":[{"label":"Yes","value":"cmd:yes"},{"label":"No","value":"cmd:no"}]}]}'
Gửi thẻ Teams qua trình bày chung: 
openclaw message send --channel msteams \
  --target conversation:19:abc@thread.tacv2 \
  --presentation '{"title":"Status update","blocks":[{"type":"text","text":"Build completed"}]}'
Gửi hình ảnh Telegram dưới dạng tài liệu để tránh nén: 
openclaw message send --channel telegram --target @mychat \
  --media ./diagram.png --force-document

​
Liên quan